Skip to main content

DVR-Scan

📼 Find and extract motion events in videos.


Latest Release: v2.0 (November 8, 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). The Scan Wizard walks you through each step: add your input videos, pick a preset, choose where to save the output, and hit Start Scan:

scan wizard

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

Metadata

Release files for dvr-scan-headless 2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dvr-scan-headless 2.0
File Size Uploaded Provenance Actions
dvr_scan_headless-2.0.tar.gz 455.7 kB With provenance Details for dvr_scan_headless-2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for dvr-scan-headless 2.0
File Interpreter ABI Platform Actions
dvr_scan_headless-2.0-py3-none-any.whl Python 3 none any Details for dvr_scan_headless-2.0-py3-none-any.whl

Total release size: 892.7 kB

Release files / dvr_scan_headless-2.0.tar.gz

Download URL dvr_scan_headless-2.0.tar.gz
Size 455.7 kB
Tags Source
SHA-256 checksum
How to use checksums
8757cabfbead85fcced3dd1a4a79bf8ff90f8448cafd6a94718cfd082097d128
BLAKE2b-256 checksum
How to use checksums
5f9a9f28855db8d5bcd15b24e6c5b188a6439f3743de878ac7aa6223c3102cda
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 9, 2026.

Transparency log

Release files / dvr_scan_headless-2.0-py3-none-any.whl

Download URL dvr_scan_headless-2.0-py3-none-any.whl
Size 437.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
25f5d3c364ff1fe5be764a76a2c0c9a22dc8a3874bb78f53c3297edd9d8c045e
BLAKE2b-256 checksum
How to use checksums
462ba5b90871891aa13a9c8fb2171d1abc9903f0867603b9b154e49fa14144b7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 9, 2026.

Transparency log

Security for dvr-scan-headless 2.0

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for dvr_scan_headless-2.0.tar.gz

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 Nov 9, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page