How borconi/openzeekr works
OpenZeekr is an Android companion for Zeekr vehicles, combining cloud-account and remote-control features with an offline BLE digital key; a Wear OS app can borrow that key. The main user journey is sign-in and vehicle setup, then viewing status or issuing a command through cloud or BLE. The graph preserves the documented proximity, provisioning, parking-research, and watch capabilities. Evidence is limited to the README, source index, and sampled excerpts; unsampled implementation details are not inferred.
Main entry points: DkBleManager.kt BLE connection · Deps.kt App dependencies · VehicleControl.kt Command dispatch · Repositories.kt Cloud repositories
Components 29
Android app
- App lifecycle
app/src/main/java/com/openzeekr/app/App.kt - App navigation
app/src/main/java/com/openzeekr/app/ui/AppRoot.kt - Vehicle controls
app/src/main/java/com/openzeekr/app/ui/VehicleScreen.kt - Account setup
app/src/main/java/com/openzeekr/app/ui/OnboardingScreen.kt - App dependencies
core/src/main/java/com/openzeekr/app/Deps.kt
Cloud services
- Encrypted settings
core/src/main/java/com/openzeekr/app/config/ConfigStore.kt - Account login
core/src/main/java/com/openzeekr/app/net/AccountLogin.kt - TSP transport
core/src/main/java/com/openzeekr/app/net/ApiClient.kt - Cloud repositories
core/src/main/java/com/openzeekr/app/remote/Repositories.kt - Vehicle status
core/src/main/java/com/openzeekr/app/remote/VehicleStatusHolder.kt - Zeekr TSP
Digital key
- Command dispatch
core/src/main/java/com/openzeekr/app/remote/VehicleControl.kt - Key identity
core/src/main/java/com/openzeekr/app/ble/DkIdentity.kt - Key provisioning
core/src/main/java/com/openzeekr/app/ble/DkProvisioning.kt - BLE connection
core/src/main/java/com/openzeekr/app/ble/DkBleManager.kt - DK session
core/src/main/java/com/openzeekr/app/ble/RealDkSession.kt - BLE protocol
core/src/main/java/com/openzeekr/app/ble/DkProtocol.kt - Lock control
core/src/main/java/com/openzeekr/app/ble/DkLockController.kt
Proximity and parking
- BLE foreground service
core/src/main/java/com/openzeekr/app/ble/ProximityService.kt - Proximity automation
core/src/main/java/com/openzeekr/app/ble/ProximityController.kt - Motion monitoring
core/src/main/java/com/openzeekr/app/ble/MotionMonitor.kt - Remote parking
core/src/main/java/com/openzeekr/app/ble/rpa/RpaController.kt
Wear companion
- Phone key sync
app/src/main/java/com/openzeekr/app/wear/PhoneKeySyncService.kt - Wear key protocol
core/src/main/java/com/openzeekr/app/wear/WearKeyProtocol.kt - Watch controls
wear/src/main/java/com/openzeekr/wear/WearApp.kt - Watch phone link
wear/src/main/java/com/openzeekr/wear/PhoneLink.kt
Other components
- Vehicle owner
- Zeekr vehicle
- Wear OS watch
Connections 37
- Vehicle owner → App navigation: uses
README.md - App navigation → Account setup: offers setup
- App navigation → Vehicle controls: offers controls
- App lifecycle → App dependencies: creates
app/src/main/java/com/openzeekr/app/App.kt - App dependencies → Encrypted settings: loads
core/src/main/java/com/openzeekr/app/Deps.kt - App dependencies → TSP transport: creates
core/src/main/java/com/openzeekr/app/Deps.kt - App dependencies → Cloud repositories: creates
core/src/main/java/com/openzeekr/app/Deps.kt - Account setup → Account login: signs in
- Account login → TSP transport: uses
- TSP transport → Zeekr TSP: sends requests
README.md - Cloud repositories → TSP transport: uses
core/src/main/java/com/openzeekr/app/remote/Repositories.kt - Cloud repositories → Zeekr TSP: requests vehicle data
- App lifecycle → Vehicle status: starts polling
app/src/main/java/com/openzeekr/app/App.kt - Vehicle controls → Command dispatch: issues commands
app/src/main/java/com/openzeekr/app/ui/VehicleScreen.kt - Command dispatch → BLE connection: tries BLE first
README.md - Command dispatch → Cloud repositories: falls back cloud
README.md - App dependencies → BLE connection: creates
core/src/main/java/com/openzeekr/app/Deps.kt - App dependencies → Key identity: loads identity
core/src/main/java/com/openzeekr/app/Deps.kt - App dependencies → Key provisioning: creates
core/src/main/java/com/openzeekr/app/Deps.kt - BLE connection → DK session: establishes
core/src/main/java/com/openzeekr/app/ble/DkBleManager.kt - BLE connection → BLE protocol: uses framing
core/src/main/java/com/openzeekr/app/ble/DkBleManager.kt - Lock control → DK session: sends controls
core/src/main/java/com/openzeekr/app/ble/DkLockController.kt - Command dispatch → Lock control: actuates key
- BLE connection → Zeekr vehicle: connects over BLE
README.md - Key provisioning → Zeekr vehicle: pairs key
README.md - BLE foreground service → BLE connection: manages link
core/src/main/java/com/openzeekr/app/ble/ProximityService.kt - BLE foreground service → Proximity automation: runs automation
- Proximity automation → BLE connection: monitors RSSI
core/src/main/java/com/openzeekr/app/ble/ProximityController.kt - Proximity automation → Lock control: locks vehicle
core/src/main/java/com/openzeekr/app/ble/ProximityController.kt - BLE foreground service → Motion monitoring: uses motion
core/src/main/java/com/openzeekr/app/ble/ProximityService.kt - Remote parking → DK session: uses session
core/src/main/java/com/openzeekr/app/ble/rpa/RpaController.kt - Phone key sync → Wear key protocol: encodes messages
app/src/main/java/com/openzeekr/app/wear/PhoneKeySyncService.kt - Watch phone link → Wear key protocol: uses messages
wear/src/main/java/com/openzeekr/wear/PhoneLink.kt - Watch controls → Watch phone link: communicates through
wear/src/main/java/com/openzeekr/wear/WearApp.kt - Wear OS watch → Watch controls: uses
README.md - Phone key sync → Wear OS watch: shares key
README.md - Watch controls → BLE connection: controls directly
README.md