Argus is an edge-optimized Tesla Dashcam and Sentry Mode manager implemented as a single Go binary with an embedded web UI. It is designed for unattended, in-car operation with low CPU and RAM footprint.

Argus turns a Raspberry Pi into a Tesla-compatible multi-LUN USB storage device while also exposing a local web UI for management:

• Presents TeslaCam/LightShow/Music storage over USB gadget mode
• Supports mode switching between:
  • Present mode (Tesla-facing USB gadget)
  • Edit mode (RW mounts + Samba/file management)
• Provides a web interface for:
  • Video/event browsing with playback, telemetry overlay, and downloads
  • Chimes/lightshows/wraps/music management
  • Cleanup policies and analytics
  • WiFi, Bluetooth, AP, Samba, Telegram, and webhook configuration
  • Runtime settings
• Includes unattended reliability features:
  • Startup boot pipeline
  • Optional fsck checks on boot
  • Optional cleanup on boot
  • Optional random chime selection on boot
  • Hardware watchdog integration
  • AP fallback with WiFi reconnect monitoring
  • Telegram and webhook alerting for Sentry events

• Backend: Go (USB gadget, mounts, loops, Samba orchestration, AP/Wi-Fi, Bluetooth, Telegram, webhook, scheduler)
• Frontend: Next.js static export embedded in the Go binary
• Delivery model: single self-contained executable
• Configuration: single config.yaml source of truth

• Raspberry Pi Zero 2 W (primary target)
• microSD with enough space for OS + image files
• Reliable data USB cable (not charge-only)

Argus is intended to run on Raspberry Pi OS Lite for unattended deployments.

• Linux kernel with USB OTG gadget support (dwc2, libcomposite, configfs)
• systemd
• root privileges for setup/system operations

cmd/argus/        Go entrypoint + CLI commands
internal/         API, services, system integrations
web/              Next.js frontend source
config.yaml       Reference configuration (see ~/.argus/config.yaml on device)
scripts/          install-argus.sh (one-command install from GitHub)
Makefile          Build/test orchestration

argus run [--config path]
argus generate [--output path] [--force]
argus setup [--dir path] [--show-size 10G] [--music-size 32G]
argus upgrade [--yes]
argus remove [--yes] [--keep-images]
argus refresh-service
argus version

Releases ship a raw Linux binary per architecture (no archive). Names match GoReleaser, e.g. argus_1.2.3_linux_arm64.

curl -fsSL https://raw.githubusercontent.com/ulm0/argus/main/scripts/install-argus.sh | sudo bash
argus generate
sudo argus setup

This installs the latest release binary for your CPU (arm64 / armv7 / armv6). If you prefer not to pipe from the network, clone the repo and run sudo bash scripts/install-argus.sh, or open the releases page and sudo install -m 0755 the argus_*_linux_* file that matches your Pi.

After setup, upgrades on the device are: sudo argus upgrade (same raw binary layout).

make deps
make all
make test

Frontend dev:

cd web
pnpm dev

Backend dev:

go run ./cmd/argus run config.yaml

All runtime settings are in ~/.argus/config.yaml.

argus setup generates unattended-friendly defaults:

• installation.boot_present_on_start: true
• installation.boot_block_until_ready: true
• installation.boot_cleanup_on_start: true
• installation.boot_random_chime_on_start: false
• disk_images.boot_fsck_enabled: true
• system.watchdog_enabled: true
• system.watchdog_timeout_sec: 60 (Debian watchdog daemon, TeslaUSB-style)
• system.reapply_sysctl_on_start: true

The Settings page includes a Startup & Reliability section:

• Present on startup
• Block startup until boot pipeline completes
• Boot cleanup
• Random chime on startup
• Boot fsck checks
• Watchdog via Debian watchdog.service (/etc/watchdog.conf) + timeout
• Sysctl profile re-apply on startup

Some changes take effect on next service restart or reboot.

• Multi-LUN presentation for TeslaCam + optional partitions
• RO local mounts in Present mode for safe read access
• RW mounts in Edit mode for management operations
• Safe mode transition sequencing (unmount/loop/gadget orchestration)
• USB gadget state recovery for hung gadget conditions

• Browse SavedClips, SentryClips, and RecentClips by event
• Play videos with multi-camera switching and HTTP range support
• Encrypted clip detection (Tesla-locked files displayed distinctly)
• SEI telemetry extraction — GPS, speed, battery, gear, and more as overlay or JSON
• HUD overlay and interactive map overlay with configurable scale
• Download individual video files or full events as ZIP (all cameras + metadata)
• Per-event thumbnails auto-generated from the first available camera
• Session grouping for RecentClips
• Optional secondary archive path for historical TeslaCam data

• Upload, rename, delete, and preview lock chimes
• Set the active lock chime
• Chime scheduling — weekly, specific date, holiday, or recurring schedules
• Chime groups — organize chimes for random selection
• Random mode — randomly pick from a configured group on each event or at boot
• Duration constraints enforced for Tesla compatibility

• Upload, download, and delete light shows (FSEQ + audio pairs)
• Upload, thumbnail-preview, download, and delete wrap images

• Hierarchical directory browsing
• Upload (single or chunked for large files), stream, move, rename, delete
• Create and delete directories

• Storage health scoring with alerts and recommendations
• Partition usage stats per LUN
• Video statistics and recording-time estimates by folder
• System metrics: CPU usage, temperature, clock speed, RAM, and power consumption

• Per-folder retention policies (keep last N events for SavedClips, SentryClips, RecentClips)
• Dry-run preview before executing
• Optional boot-time cleanup

• Access Point — offline AP fallback with configurable SSID, passphrase, channel, and DHCP; force-on/auto/force-off modes; RSSI-based activation threshold; reconnect grace period and retry cycles
• AP internet sharing — NAT routing for AP clients through the Pi's upstream (WiFi or Bluetooth)
• WiFi client management — scan networks, connect, view saved networks, forget, set autoconnect priority
• WiFi reconnect reliability — signal strength monitoring, grace periods, and retry cycles before AP activates
• Bluetooth tethering (PAN) — manage the Bluetooth adapter (power, discoverable mode), scan, pair, connect, and disconnect devices for phone-tethered internet upstream
• Captive portal detection — responds to standard probes from Apple, Android, and Windows clients

• Telegram — send Sentry event clips via bot; configurable HD/SD quality; offline queueing with configurable max queue size
• Webhook — HTTP POST callbacks with optional HMAC-SHA256 request signing

• Enable/disable Samba service
• Set Samba password and regenerate config via web UI
• Restart service from Settings page

• Reboot and power off from the web UI

• Check for updates at startup
• Optional automatic binary updates
• Update channels: stable, beta, dev

• Server-Sent Events (SSE) for live log streaming and Sentry event notifications
• System metrics dashboard with periodic polling

• Speed unit (kph / mph)
• HUD overlay scale
• Map overlay scale

Argus is heavily based on TeslaUSB concepts and workflow.
Huge thanks to the TeslaUSB project and contributors.

See repository files for license information.