Video-Summary/configs

Configuration Profiles

This directory contains pre-configured YAML files for common use cases.

Available Profiles

default.yaml

Balanced settings suitable for most indoor surveillance scenarios.

• Good balance between sensitivity and noise reduction
• Moderate processing speed
• Use when: Processing typical indoor surveillance footage

high-sensitivity.yaml

Optimized for detecting smaller movements and objects.

• Lower detection thresholds
• Shorter minimum layer lengths
• Less frame averaging
• Use when: You need to catch subtle movements or smaller objects
• Use when: Indoor scenes with good lighting

low-sensitivity.yaml

Reduced sensitivity to avoid false positives from environmental noise.

• Higher detection thresholds
• Longer minimum layer lengths
• More frame averaging
• Use when: Outdoor scenes with weather changes (clouds, wind)
• Use when: You want to focus only on significant movements
• Use when: Reducing false positives is more important than catching everything

fast.yaml

Optimized for processing speed at the cost of some accuracy.

• Lower resolution processing (480p instead of 700p)
• Smaller buffers
• Minimal averaging
• Use when: Quick preview or testing
• Use when: Processing very long videos
• Use when: Running on limited hardware

Usage

# Use a specific profile
python main.py input_video.mp4 output_dir configs/default.yaml

# Override specific settings with environment variables
export VIDEO_SUMMARY_THRESHOLD=10
python main.py input_video.mp4 output_dir configs/default.yaml

Creating Custom Profiles

Copy any of these files and modify parameters to create your own profile:

cp configs/default.yaml configs/my-custom.yaml
# Edit my-custom.yaml with your preferred settings
python main.py input_video.mp4 output_dir configs/my-custom.yaml

Parameter Tuning Guide

Increasing Sensitivity (detect more movement)

• Decrease threshold (e.g., 4-5)
• Decrease min_area (e.g., 100-200)
• Decrease minLayerLength (e.g., 20-30)

Decreasing Sensitivity (reduce noise)

• Increase threshold (e.g., 10-15)
• Increase min_area (e.g., 500-1000)
• Increase minLayerLength (e.g., 60-100)
• Increase avgNum (e.g., 15-20)

Improving Performance

• Decrease resizeWidth (e.g., 480-600)
• Decrease videoBufferLength (e.g., 100-150)
• Decrease avgNum (e.g., 5)

Handling Outdoor Scenes

• Increase avgNum (e.g., 15-20) to smooth out clouds/leaves
• Increase threshold (e.g., 10-12)
• Increase ttolerance (e.g., 80-100) for wind-affected objects