📼 Find and extract motion events in videos.
Website: dvr-scan.com
User Guide: dvr-scan.com/guide
Documentation: dvr-scan.com/docs
Discord: discord.gg/69kf6f2Exb
DVR-Scan is a command-line application that automatically detects motion events in video files (e.g. security camera footage). DVR-Scan looks for areas in footage containing motion, and saves each event to a separate video clip. DVR-Scan is free and open-source software, and works on Windows, Linux, and Mac.
pip install dvr-scan --upgrade
Windows builds (installer + portable) are also available on the Downloads page.
Start DVR-Scan (run dvr-scan-app or click the app shortcut), Add your input videos, and hit Start:
See the User Guide for a more comprehensive overview.
Scan video.mp4 (separate clips for each event):
dvr-scan -i video.mp4
Select a region to scan using the region editor:
dvr-scan -i video.mp4 -r
Select a region to scan using command line (list of points as X Y):
dvr-scan -i video.mp4 -a 50 50 100 50 100 100 100 50
Draw boxes around motion:
dvr-scan -i video.mp4 -bb
Use ffmpeg to extract events:
dvr-scan -i video.mp4 -m ffmpeg
See the documentation for a complete list of all command-line and configuration file options which can be set. You can also type dvr-scan --help for an overview of command line options. Some program options can also be set using a config file.
Copyright © 2016-2025 Brandon Castellano. All rights reserved. Licensed under BSD 2-Clause (see the LICENSE file for details).