:vhs: Find and extract motion events in videos.
Latest Release: v1.8.2.1 (May 9, 2026)
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.
Quick Install
pip install dvr-scan --upgrade
Windows builds (installer + portable) are also available on the Downloads page.
Quickstart (UI)
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.
Quickstart (CLI)
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-2026 Brandon Castellano. All rights reserved. Licensed under BSD 2-Clause (see the LICENSE file for details).
1 maintainer
Metadata
1 maintainer
Release files for dvr-scan-headless 1.8.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| dvr_scan_headless-1.8.2.1.tar.gz | 330.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dvr_scan_headless-1.8.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 678.6 kB
Release files / dvr_scan_headless-1.8.2.1.tar.gz
| Download URL | dvr_scan_headless-1.8.2.1.tar.gz |
|---|---|
| Size | 330.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cfb9425272231ee4f686a0465c37d570bb7fea1a1aa23616eb36167b038f938a
|
|
BLAKE2b-256 checksum How to use checksums |
9476b06ed0645e23b1d37368de06e89a3f31e5c9aa4c67bb062fee68388f4b09
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 9, 2026.
Transparency logRelease files / dvr_scan_headless-1.8.2.1-py3-none-any.whl
| Download URL | dvr_scan_headless-1.8.2.1-py3-none-any.whl |
|---|---|
| Size | 348.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2b7eb54c2a63d7f42919bf688db28ddbf1e81462f0f4be6235fc1a2b298d3959
|
|
BLAKE2b-256 checksum How to use checksums |
163759551a09997fe31f22d56b17571819ff6d4f75e54085977d551e7358c8ca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 9, 2026.
Transparency log
