Tesla GPS is a simple command-line tool to stream your Tesla vehicle's GPS coordinates in real-time and save them in GPX format.
API-calls can prevent the vehicle from going to sleep, which would cause the battery of the vehicle to drain while idle at a higher rate than normal (vampire drain). The software will try to prevent this, using a similar method to TeslaFi.
If you miss gps-data (or you want your vehicle to stay awake), run the software with the --wakeup
flag. This will keep the vehicle awake.
If you notice that your vehicle's battery is draining faster than normal, stop the software and file an issue.
If you don't have Go installed, you can download it from the official Go website and follow the installation instructions for your operating system.
Make sure to set your GOPATH
environment variable and add $GOPATH/bin
to your PATH
variable, as described in the Go documentation.
To use Tesla GPS, you need a Tesla API token. You can obtain one by following the instructions in the Tesla JSON API (Unofficial) Documentation.
Alternatively, you can use the Android 'Tesla Tokens' app to obtain the token: Google Play Store
Create a JSON file with the following structure, replacing my-refresh-token
with the refresh token you obtained:
{
"refresh_token": "my-refresh-token"
}
- Clone this repository:
git clone https://github.com/tijszwinkels/tesla-gps.git
- Change the directory to the repository:
cd tesla-gps
- Build the executable:
go build
To stream GPS data and save it to a GPX file, run:
./tesla-gps --token /path/to/your/token > output.gpx
Replace /path/to/your/token with the path to your Tesla API token file.
To view the live updates of the GPX file while it's being written, open another terminal and run:
tail -f output.gpx
To save the GPX data in a separate file per day, you can use the gpx-per-day.sh script.
- Make sure you have the tesla token in a t.token file in the current directory.
- Run the script:
./gpx-per-day.sh
This will start saving the GPS data in a separate file for each day, named with the format YYYY-MM-DD.gpx.
This project is released under the MIT License.