Skip to content

📼 Tool for extracting scenes with motion from videos (e.g. security camera or DVR footage). Written in Python, uses OpenCV.

License

Notifications You must be signed in to change notification settings

Breakthrough/DVR-Scan

Repository files navigation

DVR-Scan Logo

📼 Find and extract motion events in videos.


Latest Release: v1.6.2 (December 17, 2024)

Website: dvr-scan.com

User Guide: dvr-scan.com/guide

Documentation: dvr-scan.com/docs


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.

Quick Install

pip install dvr-scan[opencv] --upgrade

Windows builds are also available on the Downloads page.

Quickstart

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

example of region editor

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

example of bounding boxes

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-2024 Brandon Castellano. All rights reserved. Licensed under BSD 2-Clause (see the LICENSE file for details).

About

📼 Tool for extracting scenes with motion from videos (e.g. security camera or DVR footage). Written in Python, uses OpenCV.

Resources

License

Stars

Watchers

Forks

Packages

No packages published