TeslaBatteryBLE
Android app that tracks Tesla battery statistics directly over Bluetooth LE
TeslaBatteryBLE talks to a Tesla over Bluetooth LE using an enrolled vehicle key —
the same local protocol Tesla's vehicle-command
uses. No Tesla account, no virtual-key cloud registration, no telemetry. Install the
app, pair a key with an NFC card tap on the console, and read the car directly.
Screenshots
Light and dark themes, side by side.
Light
Dark
Features
- Scan for nearby Teslas, pair a key with an NFC card tap, then read the battery and charge state over an encrypted session
- Battery history graph, drive graph, charge cost at your home price, trip card and past trips
- Background tracking that lets the car sleep; the car is woken only when you ask
- Metric or imperial units, light and dark themes
- Everything is computed on-device; the app has no internet permission
All features in detail: docs/features.md. What is planned: docs/master-plan.md.
Install
Download the APK from Releases (prereleases are signed with the owner key), or let Obtainium keep it updated: add https://github.com/opencartools/TeslaBatteryBLE, and turn on Include prereleases to follow tagged betas.
To follow main, every push that passes CI updates one prerelease titled Preview of main. Set Obtainium's release-title filter to ^Preview, turn on Include prereleases and Fall back to older releases. Do not uninstall the app to switch signing keys, because that wipes the car pairing key. Details: docs/install.md.
No stable release has shipped yet.
Build from source
Requires JDK 21 and Android SDK 37.
./gradlew :app:assembleDebug # debug APK in app/build/outputs/apk/debug/
./gradlew :protocol:test :core:test # unit tests, no device needed
On Windows, use .\gradlew. Test, lint and CI details: CONTRIBUTING.md and docs/ci.md.
Architecture
Three modules: protocol/ (pure-JVM Tesla BLE protocol), core/ (battery domain, no Android) and app/ (Compose UI, BLE, tracking service). See docs/README.md, docs/protocol/ and docs/adr/.
Contributing
Contributions are welcome. Start with CONTRIBUTING.md — dev
setup, module map, and test expectations. Issues and pull requests use templates
in .github/.
Security & privacy
SECURITY.md — how to report vulnerabilities privatelyPRIVACY.md — what the app does (and deliberately does not do) with data
Support
TeslaBatteryBLE is free, ad-free, and telemetry-free. If it's useful to you, you
can support development via GitHub Sponsors.
Donations help cover development costs (test hardware, tooling) and keep the
project independent.
License
TeslaBatteryBLE is licensed under the GNU Affero General Public License v3.0 only
(AGPL-3.0-only). Third-party components and ported protocol definitions are
listed in THIRD_PARTY_NOTICES.md.
Not affiliated with, endorsed by, or sponsored by Tesla, Inc. "Tesla" is a
trademark of Tesla, Inc., used here only to describe interoperability.
