How yash-srivastava/overdrive-release works
OverDrive is an on-device BYD head-unit app for dashcam recording, sentry/proximity monitoring, vehicle telemetry and control, and remote integrations. The main user workflow is camera and vehicle events entering the app, being monitored or recorded, then surfaced through overlays, a recording library, or notifications; users can also configure automations and remote access. The graph includes documented MQTT/Home Assistant and tunnel capabilities. Sampled excerpts are partial, so uncertain wiring among unsampled subsystems is omitted.
Main entry points: OemDashcamPipeline.java Dashcam pipeline · BydDataCollector.java Vehicle telemetry · VehicleActuatorService.java Vehicle controls · SentryDaemon.java Sentry daemon
Components 22
App runtime
- OverDrive app
app/src/main/java/com/overdrive/app/OverdriveApplication.kt - Background daemons
app/src/main/java/com/overdrive/app/daemon - Configuration
app/src/main/java/com/overdrive/app/config/UnifiedConfigManager.kt - Status overlay
app/src/main/java/com/overdrive/app/overlay/StatusOverlayService.java
Camera and sentry
- Camera daemon
app/src/main/java/com/overdrive/app/daemon/CameraDaemon.java - Dashcam pipeline
app/src/main/java/com/overdrive/app/camera/OemDashcamPipeline.java - Motion detection
app/src/main/cpp/surveillance/motion_pipeline_v2.cpp - Instant replay
app/src/main/java/com/overdrive/app/recording/ManualClipService.java - Sentry daemon
app/src/main/java/com/overdrive/app/daemon/SentryDaemon.java
Vehicle features
- Vehicle telemetry
app/src/main/java/com/overdrive/app/byd/BydDataCollector.java - Vehicle controls
app/src/main/java/com/overdrive/app/services/VehicleActuatorService.java - Automations
app/src/main/java/com/overdrive/app/automation/Automations.java - Trip scoring
app/src/main/java/com/overdrive/app/trips/TripScoreEngine.java
Remote integrations
- MQTT publisher
app/src/main/java/com/overdrive/app/mqtt/MqttPublisherService.java - Remote access tunnels
app/src/main/java/com/overdrive/app/launcher - Telegram bot
app/src/main/java/com/overdrive/app/daemon/telegram/TelegramDaemonLauncher.java
Other components
- Driver
- Vehicle cameras
- BYD vehicle
- MQTT broker
- Home Assistant
- Remote user
Connections 22
- Driver → OverDrive app: configures
- OverDrive app → Configuration: reads settings
- Background daemons → Camera daemon: runs
- Camera daemon → Dashcam pipeline: records with
- Vehicle cameras → Dashcam pipeline: supplies frames
- Sentry daemon → Motion detection: detects motion
- Sentry daemon → Dashcam pipeline: triggers recording
- Driver → Instant replay: requests replay
- Instant replay → Dashcam pipeline: exports buffered clip
- Dashcam pipeline → Status overlay: reports state
- BYD vehicle → Vehicle telemetry: provides telemetry
- Vehicle telemetry → MQTT publisher: publishes data
- MQTT publisher → MQTT broker: publishes telemetry
- MQTT broker → Home Assistant: delivers telemetry
- Home Assistant → MQTT broker: sends commands
- MQTT broker → Vehicle controls: dispatches commands
- Vehicle controls → BYD vehicle: controls
- Vehicle telemetry → Automations: provides state
- Automations → Vehicle controls: executes actions
- Vehicle telemetry → Trip scoring: supplies trip samples
- Remote access tunnels → Remote user: enables remote access
- Telegram bot → Remote user: sends alerts