CamReview¶
CamReview is a local command-line tool for developers and camera operators who need to find motion in existing security-camera recordings. It groups motion into reviewable events, writes portable reports, and can classify or extract selected footage without running an NVR, service, or database.
Key features¶
- Scans timestamped MKV, MP4, MOV, and AVI recordings as a continuous timeline.
- Uses sampled, presentation-timestamp-aware decoding with bounded memory.
- Records motion events, missing intervals, file problems, settings, and performance.
- Writes canonical JSON plus CSV and text views through atomic replacement.
- Supports local disks, mapped drives, UNC paths, and mounted SMB/CIFS shares.
- Optionally classifies moving COCO objects with Ultralytics YOLO.
- Copies source recordings or creates event-sized clips without changing originals.
Quick start¶
Install CamReview and scan one directory of correctly named recordings:
The current directory receives garage_2026-08-12_motion.json, .csv, and .txt. See
Getting started for input naming, verification, and a complete first
run.
Where to next¶
Getting started
Go from a clone to a motion report
Installation
Set up the base, detection, or development dependencies
Command reference
Look up commands, flags, defaults, and examples
Configuration
Configure motion, decoding, classification, and masks
Architecture
Follow the processing pipeline and code boundaries
Support¶
File a GitHub issue
with the command, exit code, relevant console output, and the issues section from the JSON
report. Do not attach private footage unless you intend to share it.