# Install dvr-scan with Homebrew, Nix

Extract scenes with motion from videos. Version 1.8.2.1 via Homebrew; verified 2026-06-22.

## Install

```sh
sudo av install brew:dvr-scan
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install dvr-scan
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#dvr-scan
```

  Evidence: nixpkgs package indexes: pkgs/by-name/dv/dvr-scan/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:dvr-scan
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/dvr-scan>
- **Version:** 1.8.2.1
- **Source summary:** Extract scenes with motion from videos
- **Homepage:** <https://www.dvr-scan.com/>
- **Repository:** <https://github.com/Breakthrough/DVR-Scan>
- **Upstream docs:** <https://www.dvr-scan.com/docs>
- **License:** BSD-2-Clause
- **Source archive:** <https://files.pythonhosted.org/packages/47/84/a3256473a827f0c17e3e724c409a33146a26d6515f87df38c3a649547b7d/dvr_scan-1.8.2.1.tar.gz>
- **Last updated:** 2026-06-22T10:02:00-04:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- dvr-scan (cli)
- dvr-scan-app (cli)
- dvr-scan (alias)
- dvr-scan-app (alias)

## Dependencies

- ffmpeg
- numpy
- opencv
- pillow
- python@3.14

## Build dependencies

- cmake
- pkgconf

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.8.2.1
- Package-manager updated: 2026-06-22
- Local data: ok
- Upstream repository: https://www.dvr-scan.com/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

DVR-Scan is a free, open-source command-line and GUI application for finding motion events in video files, especially security-camera and DVR footage, and saving those events as separate clips.

### Project history

The GitHub repository was created on 31 December 2016, and GitHub release metadata records DVR-Scan 1.0 in January 2017. The official site identifies Brandon Castellano as the copyright holder and presents DVR-Scan as BSD-licensed software.

The project has expanded from a CLI-focused utility into a tool with both the dvr-scan command and dvr-scan-app UI. Its documentation now covers region editing, motion thresholds, background subtractors, ffmpeg output, OpenCV output, overlays, logs, and config-file settings.

### Adoption history

DVR-Scan's adoption is niche and task-driven: users install it when they need to extract useful segments from long camera footage without reviewing the whole file manually. The input metadata lists Homebrew and Nix packages, while the official site provides cross-platform Windows, Linux, and Mac positioning.

Its package-manager value comes from bundling a repeatable computer-vision workflow behind a small CLI, so surveillance, dashcam, and archival video jobs can be scripted.

### How it is used

Typical CLI usage starts with dvr-scan -i video.mp4 to scan an input and write separate motion-event clips. The docs also show region-of-interest scanning, bounding boxes around detected motion, ffmpeg extraction, multiple input files, and scan-only modes.

Most options can be set in dvr-scan.cfg, and the official docs specify the default config locations on Windows, Linux, and macOS.

### Why package nerds care

DVR-Scan is package-nerd interesting because it exposes OpenCV-style motion detection as an installable end-user command instead of asking users to write a computer-vision script. It also demonstrates a common packaging challenge: media tools often sit on top of heavy native dependencies such as OpenCV and ffmpeg but still need to feel like one simple command.

### Timeline

- 2016: The official GitHub repository is created.
- 2017: GitHub release metadata records DVR-Scan 1.0.
- 2026: The official site lists DVR-Scan 1.8.2 in January 2026.

### Related projects

- OpenCV is related because DVR-Scan uses background subtraction and video processing.
- ffmpeg is related because DVR-Scan can use it to extract detected motion events.
- PySceneDetect is adjacent in the author's video-analysis ecosystem and shares the general task area of automated video segmentation.

### Sources

- <https://www.dvr-scan.com/>
- <https://www.dvr-scan.com/docs>
- <https://api.github.com/repos/Breakthrough/DVR-Scan>
- <https://api.github.com/repos/Breakthrough/DVR-Scan/releases>


## Security Notes

No matching local secret-handling manifest was found for dvr-scan. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Linux: ~/.config/DVR-Scan/dvr-scan.cfg
- macOS: ~/Library/Preferences/DVR-Scan/dvr-scan.cfg
- Windows: C:/Users/%USERNAME%/AppData/Local/DVR-Scan/dvr-scan.cfg
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** dvr-scan
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - dvr-scan: normalized package name match | nixpkgs package indexes: pkgs/by-name/dv/dvr-scan/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Media and graphics packages](https://www.automicvault.com/pkg/media-graphics-tools/) - Matched media, image, audio, video, or graphics metadata.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [ffmpeg](https://www.automicvault.com/pkg/brew/ffmpeg/) - Runtime dependency declared by Homebrew.
- [numpy](https://www.automicvault.com/pkg/brew/numpy/) - Runtime dependency declared by Homebrew.
- [opencv](https://www.automicvault.com/pkg/brew/opencv/) - Runtime dependency declared by Homebrew.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Build dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [bento4](https://www.automicvault.com/pkg/brew/bento4/) - Shares av.db curated category or tags: cli, media, video.
- [ccextractor](https://www.automicvault.com/pkg/brew/ccextractor/) - Shares av.db curated category or tags: cli, media, video.
- [dvanalyzer](https://www.automicvault.com/pkg/brew/dvanalyzer/) - Shares av.db curated category or tags: cli, media, video.
- [ffmpeg-full](https://www.automicvault.com/pkg/brew/ffmpeg-full/) - Shares av.db curated category or tags: cli, media, video.
- [ffmpeg2theora](https://www.automicvault.com/pkg/brew/ffmpeg2theora/) - Shares av.db curated category or tags: cli, media, video.
- [ffmpegthumbnailer](https://www.automicvault.com/pkg/brew/ffmpegthumbnailer/) - Shares av.db curated category or tags: cli, media, video.
- [ffms2](https://www.automicvault.com/pkg/brew/ffms2/) - Shares av.db curated category or tags: cli, media, video.
- [manim](https://www.automicvault.com/pkg/brew/manim/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, ffmpeg, media, numpy, pillow.
- [vs-preview](https://www.automicvault.com/pkg/brew/vs-preview/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, media, numpy, pillow, python.
- [yle-dl](https://www.automicvault.com/pkg/brew/yle-dl/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, ffmpeg, media, python, python-3-14.

## Combined YAML source

View the package source record on GitHub. [combined/dvr-scan.yml](https://github.com/automic-vault/db/blob/main/combined/dvr-scan.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
