So far the only Android app that tracks Tesla battery usage - directly over Bluetooth LE.
翻譯準備中
取自儲存庫 README
正在載入完整 README。
檢視完整 README ↗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.
Light and dark themes, side by side.
Light
Dark
All features in detail: docs/features.md. What is planned: docs/master-plan.md.
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.
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.
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/.
Contributions are welcome. Start with CONTRIBUTING.md — dev
setup, module map, and test expectations. Issues and pull requests use templates
in .github/.
SECURITY.md — how to report vulnerabilities privatelyPRIVACY.md — what the app does (and deliberately does not do) with dataTeslaBatteryBLE 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.
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.