Add Snapshot

config.env.example

@@ -112,6 +112,30 @@ EXPORT_CSV=true
 # Path where the crossing CSV is written
 CROSS_CSV=/opt/batch-counter/crossings.csv
 
+# --- Crossing snapshots ---
+# Save an annotated frame image every time an object crosses a line and the
+# counter increases (true/false, default: false). Written to <DIR>/cross/
+# (filename: <YYYYmmdd_HHMMSS_mmm>_<in|out>_id<track>_f<frame>.jpg)
+SAVE_CROSS_SNAPSHOT=false
+# Also save one snapshot the first time each object is detected, before it crosses
+# (true/false, default: false). Written to <DIR>/detect/ with the same track id so
+# it can be correlated with the crossing snapshot
+# (filename: <YYYYmmdd_HHMMSS_mmm>_detect_id<track>_f<frame>.jpg)
+SAVE_DETECT_SNAPSHOT=false
+# Base directory for snapshots (detect/ and cross/ subfolders are created inside).
+# The dashboard reads this same path to display the snapshot gallery, so keep it
+# identical for both the counter and the dashboard.
+CROSS_SNAPSHOT_DIR=/opt/batch-counter/snapshots
+# JPEG quality for snapshots (1-100)
+CROSS_SNAPSHOT_QUALITY=85
+# Retention: keep at most this many snapshot files (detect + cross combined);
+# oldest are deleted first (0 = unlimited)
+CROSS_SNAPSHOT_MAX_FILES=1000
+# Retention: delete snapshots older than this many days (0 = never by age)
+CROSS_SNAPSHOT_MAX_AGE_DAYS=7
+# Run the cleanup sweep at most once every N seconds
+CROSS_SNAPSHOT_CLEANUP_SEC=60
+
 # --- Rate / performance ---
 # Enable motion detection pre-filter: skip inference on frames with no movement
 # (true/false, default: false). When enabled, frames below MOTION_THRESHOLD are