TeslaOnTarget

Bridge your Tesla vehicle with TAK (Team Awareness Kit) servers for real-time position tracking.

What is TeslaOnTarget?

TeslaOnTarget is a lightweight Python application that connects your Tesla vehicle to a TAK (Team Awareness Kit) server, enabling real-time vehicle tracking in tactical awareness applications. It bridges the gap between Tesla's modern API and military/emergency response systems that use Cursor on Target (CoT) messaging.

Use Cases

• Emergency Response - Track response vehicles in real-time
• Fleet Management - Monitor multiple Tesla vehicles on a single TAK display
• Personal Tracking - Keep tabs on your vehicle's location and status
• Integration Testing - Test TAK systems with real vehicle data

Features

• Real-time Vehicle Tracking - GPS position updates every 10 seconds
• Battery & Charging Status - Monitor charge level and time to completion
• Smart Wake Management - Wakes vehicle only once, preserves battery when parked
• Multi-TAK Compatible - Tested with iTAK, ATAK, and WebTAK
• Security Alerts - Warnings for open windows/doors when parked
• Dead Reckoning - Smooth 1Hz position updates between 10-second API polls
• Resilient Connection - Automatic reconnection and error recovery
• Detailed Logging - Comprehensive logs for troubleshooting
• Secure Token Storage - OAuth2 token management via TeslaPy
• Location Caching - Continues reporting last position when vehicle sleeps

Requirements

• Python 3.7+
• Tesla Account with a vehicle
• TAK Server (one of the following):
  • OpenTAKServer
  • TAK Server (Official)
  • Any CoT-compatible server
• Network Access to both internet (Tesla API) and your TAK server

⚠️ Important Security Note

This version only supports plaintext TCP connections to TAK servers. SSL/TLS/QUIC support is planned for a future release. For security:

• Run TeslaOnTarget on the same network as your TAK server
• Ideally run it directly on the TAK server machine
• Do NOT expose across WAN/Internet connections
• Use VPN if remote access is required

Quick Start

Option 1: Docker (Recommended)

Using Pre-built Image (Easiest)

# Pull the latest image
docker pull ghcr.io/joshuafuller/teslaontarget:latest

# Create configuration
wget https://raw.githubusercontent.com/joshuafuller/TeslaOnTarget/main/.env.example
cp .env.example .env
# Edit .env with your TAK server IP and Tesla email

# Authenticate with Tesla
docker run -it --env-file .env -v tesla_data:/data ghcr.io/joshuafuller/teslaontarget auth

# Or minimal auth command (TAK_SERVER not required for auth):
# docker run -it -e TESLA_USERNAME=your@email.com -v tesla_data:/data ghcr.io/joshuafuller/teslaontarget auth

# Run TeslaOnTarget
docker run -d --env-file .env -v tesla_data:/data -v tesla_logs:/logs \
  --name teslaontarget --restart unless-stopped \
  ghcr.io/joshuafuller/teslaontarget

Building from Source

# Clone repository
git clone https://github.com/joshuafuller/TeslaOnTarget.git
cd TeslaOnTarget

# Setup configuration
cp .env.example .env
# Edit .env with your TAK server IP and Tesla email

# Build Docker image
./docker-run.sh build

# Authenticate with Tesla (one-time)
./docker-run.sh auth

# Start tracking
./docker-run.sh start

# View logs
./docker-run.sh logs

See docs/DOCKER.md for detailed Docker instructions and docs/AUTHENTICATION.md for Tesla login help.

Option 2: Traditional Installation

1. Clone & Install

git clone https://github.com/joshuafuller/TeslaOnTarget.git
cd TeslaOnTarget
pip3 install -r requirements.txt

2. Configure

Copy the template and edit with your settings:

cp config.py.template config.py
nano config.py

Required settings:

COT_URL = "tcp://192.168.1.100:8085"  # Your TAK server
TESLA_USERNAME = "your@email.com"      # Your Tesla account email

3. Authenticate with Tesla

python3 -m teslaontarget.auth

This will:

1. Open Tesla's login page in your browser
2. After login, you'll land on a "Page Not Found" error (this is normal!)
3. Copy the ENTIRE URL from your browser's address bar
4. Paste it back in the terminal when prompted

4. Start Tracking

./teslaontarget.sh start

View live logs:

./teslaontarget.sh logs

Configuration Options

| Setting | Description | Default | |---------|-------------|---------| | COT_URL | TAK server URL (tcp://host:port) | tcp://YOUR_TAK_SERVER:8085 | | API_LOOP_DELAY | Seconds between Tesla API calls | 10 | | TESLA_USERNAME | Your Tesla account email | Required | | LAST_POSITION_FILE | Cache file for position data | last_known_position.json | | DEBUG_MODE | Save all Tesla API responses for analysis | False | | DEAD_RECKONING_ENABLED | Interpolate position between API updates for smooth tracking | True | | DEAD_RECKONING_DELAY | Seconds between interpolated position updates (1 = 1Hz) | 1 |

📡 TAK Server Setup

FreeTAK Server

Default configuration should work. Ensure TCP port 8085 is open.

TAK Server

Configure a TCP input on port 8085 (or your chosen port).

Network Requirements

• Firewall must allow TCP connections to TAK server (plaintext only in v1.0)
• No authentication required (or configure as needed)
• TAK clients must be on same network or have routing to server
• Security: Keep TAK traffic on local network only due to plaintext limitation

Management Commands

Single control script for all operations:

./teslaontarget.sh start     # Start tracking in background
./teslaontarget.sh stop      # Stop tracking
./teslaontarget.sh restart   # Restart tracking
./teslaontarget.sh status    # Check if running
./teslaontarget.sh logs      # View live logs
./teslaontarget.sh help      # Show all commands

For Tesla authentication:

python3 -m teslaontarget.auth  # Set up or refresh Tesla authentication

Verifying Installation

After starting TeslaOnTarget, verify it's working:

1. Check logs: ./docker-run.sh logs (Docker) or ./teslaontarget.sh logs (Traditional)

   • Should show "Connected to TAK server"
   • Should show "Successfully sent CoT packet"

2. Check TAK client:

   • Open iTAK/ATAK/WebTAK
   • Look for your vehicle on the map
   • Verify updates every 10 seconds

3. Check status: ./docker-run.sh status

   • Should show "TeslaOnTarget is running"

Troubleshooting

Vehicle Not Appearing in TAK

1. Check TAK server connectivity: telnet your-tak-server 8085
2. Verify vehicle is online in Tesla app
3. Check logs: ./teslaontarget.sh logs
4. Ensure TAK client is connected to same server

Authentication Issues

rm cache.json
python3 -m teslaontarget.auth

Vehicle Shows Wrong Location

• Vehicle may be in parking garage (no GPS)
• Wait 10 seconds for next update
• Check if vehicle is actually at shown location

High Tesla Battery Drain

• Normal: Vehicle is woken once on startup only
• Abnormal: Check logs for repeated wake attempts
• Solution: Restart the service

📁 Project Structure

TeslaOnTarget/
├── teslaontarget/        # Main package directory
│   ├── __init__.py      # Package initialization
│   ├── __main__.py      # Entry point
│   ├── tesla_api.py     # Tesla API integration
│   ├── cot.py           # CoT message generation
│   ├── config_handler.py # Configuration management
│   ├── tak_client.py    # TAK server connection
│   ├── utils.py         # Helper functions
│   └── auth.py          # Tesla authentication
├── teslaontarget.sh     # Single control script (start/stop/status)
├── config.py            # Your configuration (don't commit!)
├── requirements.txt     # Python dependencies
├── setup.py             # Package installation
├── docs/                # Detailed documentation
│   ├── README.md        # Full documentation
│   └── tesla_api_reference.md  # Tesla API details
└── tests/               # Unit tests

Security Considerations

• Never commit config.py or cache.json to version control
• Plaintext Only: v1.0 uses unencrypted TCP - keep on local network only
• Run TeslaOnTarget on same machine or network as TAK server
• Keep your TAK server behind a firewall or VPN
• Use network segmentation for TAK infrastructure
• Rotate Tesla tokens periodically (automatic via TeslaPy)
• Monitor teslaontarget.log for suspicious activity

Multi-Vehicle Support

TeslaOnTarget supports tracking multiple vehicles from a single instance. By default, it will track all vehicles on your Tesla account. You can also configure it to track specific vehicles:

# In config.py - Track all vehicles (default)
VEHICLE_FILTER = []

# Track specific vehicles by display name
VEHICLE_FILTER = ["Model Y", "Cybertruck"]

# Track specific vehicles by VIN
VEHICLE_FILTER = ["5YJ3E1EA8NF000000", "5YJ3E1EA8NF000001"]

# Mix display names and VINs
VEHICLE_FILTER = ["Model Y", "5YJ3E1EA8NF000001"]

Each vehicle:

• Gets its own unique identifier in TAK
• Has separate position caching (last_position_VIN.json)
• Runs in its own thread for independent tracking
• Shares a single TAK server connection

Known Limitations

• No SSL/TLS support - plaintext TCP only (SSL planned for v2.0)
• Updates only when vehicle is awake or every 10 seconds wh