cang¶
cang is a snapshot archiver for IP cameras — its ingest daemon watches camera folders for snapshot images, and its web server provides a FastAPI web UI for browsing recordings, scrubbing through snapshots, and viewing live feeds.
Features¶
- Dahua camera adapter — reads JPG snapshots directly from the camera's folder structure
- Two-process architecture — cangcang handles ingest and cleanup, cangjian serves the web UI; no UI hangs during scans
- Snapshot ingestion — indexes all JPG snapshots in SQLite with motion-event metadata
- Event grouping — automatically groups consecutive motion snapshots into events using a configurable time-gap threshold
- Tiered retention — applies different expiry periods to motion snapshots (default 30 days) and background snapshots (14 days)
- Periodic camera scanning — picks up new snapshots within the configured scan interval
- FastAPI web UI — browse recordings by day, scrub through snapshots per camera with keyboard shortcuts
- Runs in a container — OCI image available on registry.marvin8.zone