DVR-Scan-Headless 1.8__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. dvr_scan_headless-1.8/DVR_Scan_Headless.egg-info/PKG-INFO +119 -0
  2. dvr_scan_headless-1.8/DVR_Scan_Headless.egg-info/SOURCES.txt +55 -0
  3. dvr_scan_headless-1.8/DVR_Scan_Headless.egg-info/dependency_links.txt +1 -0
  4. dvr_scan_headless-1.8/DVR_Scan_Headless.egg-info/entry_points.txt +2 -0
  5. dvr_scan_headless-1.8/DVR_Scan_Headless.egg-info/requires.txt +8 -0
  6. dvr_scan_headless-1.8/DVR_Scan_Headless.egg-info/top_level.txt +1 -0
  7. dvr_scan_headless-1.8/LICENSE +47 -0
  8. dvr_scan_headless-1.8/PKG-INFO +119 -0
  9. dvr_scan_headless-1.8/README.md +66 -0
  10. dvr_scan_headless-1.8/dist/package-info.rst +75 -0
  11. dvr_scan_headless-1.8/dvr-scan.cfg +200 -0
  12. dvr_scan_headless-1.8/dvr_scan/LICENSE +47 -0
  13. dvr_scan_headless-1.8/dvr_scan/__init__.py +55 -0
  14. dvr_scan_headless-1.8/dvr_scan/__main__.py +80 -0
  15. dvr_scan_headless-1.8/dvr_scan/app/__init__.py +10 -0
  16. dvr_scan_headless-1.8/dvr_scan/app/__main__.py +218 -0
  17. dvr_scan_headless-1.8/dvr_scan/app/about_window.py +137 -0
  18. dvr_scan_headless-1.8/dvr_scan/app/application.py +1700 -0
  19. dvr_scan_headless-1.8/dvr_scan/app/common.py +31 -0
  20. dvr_scan_headless-1.8/dvr_scan/app/region_editor.py +1416 -0
  21. dvr_scan_headless-1.8/dvr_scan/app/scan_window.py +258 -0
  22. dvr_scan_headless-1.8/dvr_scan/app/widgets.py +213 -0
  23. dvr_scan_headless-1.8/dvr_scan/cli.py +511 -0
  24. dvr_scan_headless-1.8/dvr_scan/config.py +607 -0
  25. dvr_scan_headless-1.8/dvr_scan/controller.py +215 -0
  26. dvr_scan_headless-1.8/dvr_scan/detector.py +124 -0
  27. dvr_scan_headless-1.8/dvr_scan/docs/404.html +1 -0
  28. dvr_scan_headless-1.8/dvr_scan/docs/assets/javascripts/bundle.88dd0f4e.min.js +15 -0
  29. dvr_scan_headless-1.8/dvr_scan/docs/assets/stylesheets/main.6f8fc17f.min.css +1 -0
  30. dvr_scan_headless-1.8/dvr_scan/docs/assets/stylesheets/palette.06af60db.min.css +1 -0
  31. dvr_scan_headless-1.8/dvr_scan/docs/changelog.html +1 -0
  32. dvr_scan_headless-1.8/dvr_scan/docs/docs.html +73 -0
  33. dvr_scan_headless-1.8/dvr_scan/docs/faq.html +13 -0
  34. dvr_scan_headless-1.8/dvr_scan/docs/guide.html +1 -0
  35. dvr_scan_headless-1.8/dvr_scan/docs/index.html +5 -0
  36. dvr_scan_headless-1.8/dvr_scan/docs/resources.html +30 -0
  37. dvr_scan_headless-1.8/dvr_scan/docs/style.min.css +1 -0
  38. dvr_scan_headless-1.8/dvr_scan/dvr-scan-logo.png +0 -0
  39. dvr_scan_headless-1.8/dvr_scan/dvr-scan.ico +0 -0
  40. dvr_scan_headless-1.8/dvr_scan/dvr-scan.png +0 -0
  41. dvr_scan_headless-1.8/dvr_scan/opencv_loader.py +37 -0
  42. dvr_scan_headless-1.8/dvr_scan/overlays.py +251 -0
  43. dvr_scan_headless-1.8/dvr_scan/platform.py +236 -0
  44. dvr_scan_headless-1.8/dvr_scan/region.py +65 -0
  45. dvr_scan_headless-1.8/dvr_scan/scanner.py +1303 -0
  46. dvr_scan_headless-1.8/dvr_scan/shared/__init__.py +287 -0
  47. dvr_scan_headless-1.8/dvr_scan/shared/cli.py +291 -0
  48. dvr_scan_headless-1.8/dvr_scan/shared/settings.py +72 -0
  49. dvr_scan_headless-1.8/dvr_scan/subtractor.py +163 -0
  50. dvr_scan_headless-1.8/dvr_scan/video_joiner.py +188 -0
  51. dvr_scan_headless-1.8/pyproject.toml +45 -0
  52. dvr_scan_headless-1.8/setup.cfg +72 -0
  53. dvr_scan_headless-1.8/tests/test_cli.py +306 -0
  54. dvr_scan_headless-1.8/tests/test_maxarea.py +111 -0
  55. dvr_scan_headless-1.8/tests/test_scan_context.py +239 -0
  56. dvr_scan_headless-1.8/tests/test_video_joiner.py +37 -0
@@ -0,0 +1,119 @@
1
+ Metadata-Version: 2.4
2
+ Name: DVR-Scan-Headless
3
+ Version: 1.8
4
+ Summary: Tool for finding and extracting motion events in video files (e.g. security camera footage).
5
+ Home-page: https://www.dvr-scan.com/
6
+ Author: Brandon Castellano
7
+ Author-email: brandon248@gmail.com
8
+ License: BSD 2-Clause License
9
+ Project-URL: Homepage, https://www.dvr-scan.com/
10
+ Project-URL: Repository, https://github.com/Breakthrough/DVR-Scan
11
+ Project-URL: Documentation, https://www.dvr-scan.com/docs
12
+ Project-URL: Bug Tracker, https://github.com/Breakthrough/DVR-Scan/issues
13
+ Keywords: video computer-vision analysis
14
+ Classifier: Development Status :: 5 - Production/Stable
15
+ Classifier: Environment :: Console
16
+ Classifier: Environment :: Console :: Curses
17
+ Classifier: Intended Audience :: Developers
18
+ Classifier: Intended Audience :: End Users/Desktop
19
+ Classifier: Intended Audience :: System Administrators
20
+ Classifier: License :: OSI Approved :: MIT License
21
+ Classifier: Operating System :: OS Independent
22
+ Classifier: Programming Language :: Python :: 3
23
+ Classifier: Programming Language :: Python :: 3.9
24
+ Classifier: Programming Language :: Python :: 3.10
25
+ Classifier: Programming Language :: Python :: 3.11
26
+ Classifier: Programming Language :: Python :: 3.12
27
+ Classifier: Programming Language :: Python :: 3.13
28
+ Classifier: Topic :: Multimedia :: Video
29
+ Classifier: Topic :: Multimedia :: Video :: Conversion
30
+ Classifier: Topic :: Multimedia :: Video :: Non-Linear Editor
31
+ Classifier: Topic :: Utilities
32
+ Requires-Python: >=3.9
33
+ Description-Content-Type: text/x-rst
34
+ License-File: LICENSE
35
+ Requires-Dist: numpy
36
+ Requires-Dist: platformdirs
37
+ Requires-Dist: scenedetect
38
+ Requires-Dist: screeninfo
39
+ Requires-Dist: tqdm
40
+ Requires-Dist: opencv-python
41
+ Requires-Dist: opencv-contrib-python
42
+ Requires-Dist: pillow
43
+ Dynamic: license-file
44
+
45
+
46
+ DVR-Scan
47
+ ==========================================================
48
+
49
+ Video Motion Event Detection and Extraction Tool
50
+ ----------------------------------------------------------
51
+
52
+ .. image:: https://img.shields.io/github/actions/workflow/status/Breakthrough/DVR-Scan/build.yml
53
+ :target: https://github.com/Breakthrough/DVR-Scan/actions
54
+
55
+ .. image:: https://img.shields.io/github/release/Breakthrough/DVR-Scan.svg
56
+ :target: https://github.com/Breakthrough/DVR-Scan
57
+
58
+ .. image:: https://img.shields.io/pypi/status/dvr-scan.svg
59
+ :target: https://github.com/Breakthrough/DVR-Scan
60
+
61
+ .. image:: https://raster.shields.io/pypi/l/dvr-scan.png
62
+ :target: http://pyscenedetect.readthedocs.org/en/latest/copyright/
63
+
64
+ .. image:: https://img.shields.io/github/stars/Breakthrough/DVR-Scan.svg?style=social&label=View%20on%20Github
65
+ :target: https://github.com/Breakthrough/DVR-Scan
66
+
67
+ ----------------------------------------------------------
68
+
69
+ Website: http://www.dvr-scan.com/
70
+
71
+ Documentation: http://dvr-scan.readthedocs.org/
72
+
73
+ Github: https://github.com/Breakthrough/DVR-Scan/
74
+
75
+
76
+ 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.
77
+
78
+ Quickstart
79
+ ----------------------------------------------------------
80
+
81
+ Install using ``pip``:
82
+
83
+ pip install --upgrade dvr-scan[opencv]
84
+
85
+ Scan ``video.mp4`` (separate clips for each event)::
86
+
87
+ dvr-scan -i video.mp4
88
+
89
+ Only scan a region of interest (`see user guide <http://www.dvr-scan.com/guide/>`_ or hit `H` for controls)::
90
+
91
+ dvr-scan -i video.mp4 -r
92
+
93
+ .. image:: https://raw.githubusercontent.com/Breakthrough/DVR-Scan/releases/1.6/docs/assets/region-editor-mask.jpg
94
+ :width: 480
95
+ :alt: overlay example
96
+
97
+ Draw boxes around motion::
98
+
99
+ dvr-scan -i video.mp4 -bb
100
+
101
+ .. image:: https://raw.githubusercontent.com/Breakthrough/DVR-Scan/releases/1.6/docs/assets/bounding-box.gif
102
+ :width: 480
103
+ :alt: overlay example
104
+
105
+ Use ``ffmpeg`` to extract events::
106
+
107
+ dvr-scan -i video.mp4 -m ffmpeg
108
+
109
+ For help or other issues, feel free to submit any bugs or feature requests to Github:
110
+
111
+ https://github.com/Breakthrough/DVR-Scan/issues
112
+
113
+ ----------------------------------------------------------
114
+
115
+ Licensed under BSD 2-Clause (see the ``LICENSE`` file for details).
116
+
117
+ Copyright (C) 2016 Brandon Castellano.
118
+ All rights reserved.
119
+
@@ -0,0 +1,55 @@
1
+ LICENSE
2
+ README.md
3
+ dvr-scan.cfg
4
+ pyproject.toml
5
+ setup.cfg
6
+ DVR_Scan_Headless.egg-info/PKG-INFO
7
+ DVR_Scan_Headless.egg-info/SOURCES.txt
8
+ DVR_Scan_Headless.egg-info/dependency_links.txt
9
+ DVR_Scan_Headless.egg-info/entry_points.txt
10
+ DVR_Scan_Headless.egg-info/requires.txt
11
+ DVR_Scan_Headless.egg-info/top_level.txt
12
+ dist/package-info.rst
13
+ dvr_scan/LICENSE
14
+ dvr_scan/__init__.py
15
+ dvr_scan/__main__.py
16
+ dvr_scan/cli.py
17
+ dvr_scan/config.py
18
+ dvr_scan/controller.py
19
+ dvr_scan/detector.py
20
+ dvr_scan/dvr-scan-logo.png
21
+ dvr_scan/dvr-scan.ico
22
+ dvr_scan/dvr-scan.png
23
+ dvr_scan/opencv_loader.py
24
+ dvr_scan/overlays.py
25
+ dvr_scan/platform.py
26
+ dvr_scan/region.py
27
+ dvr_scan/scanner.py
28
+ dvr_scan/subtractor.py
29
+ dvr_scan/video_joiner.py
30
+ dvr_scan/app/__init__.py
31
+ dvr_scan/app/__main__.py
32
+ dvr_scan/app/about_window.py
33
+ dvr_scan/app/application.py
34
+ dvr_scan/app/common.py
35
+ dvr_scan/app/region_editor.py
36
+ dvr_scan/app/scan_window.py
37
+ dvr_scan/app/widgets.py
38
+ dvr_scan/docs/404.html
39
+ dvr_scan/docs/changelog.html
40
+ dvr_scan/docs/docs.html
41
+ dvr_scan/docs/faq.html
42
+ dvr_scan/docs/guide.html
43
+ dvr_scan/docs/index.html
44
+ dvr_scan/docs/resources.html
45
+ dvr_scan/docs/style.min.css
46
+ dvr_scan/docs/assets/javascripts/bundle.88dd0f4e.min.js
47
+ dvr_scan/docs/assets/stylesheets/main.6f8fc17f.min.css
48
+ dvr_scan/docs/assets/stylesheets/palette.06af60db.min.css
49
+ dvr_scan/shared/__init__.py
50
+ dvr_scan/shared/cli.py
51
+ dvr_scan/shared/settings.py
52
+ tests/test_cli.py
53
+ tests/test_maxarea.py
54
+ tests/test_scan_context.py
55
+ tests/test_video_joiner.py
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ dvr-scan = dvr_scan.__main__:main
@@ -0,0 +1,8 @@
1
+ numpy
2
+ platformdirs
3
+ scenedetect
4
+ screeninfo
5
+ tqdm
6
+ opencv-python
7
+ opencv-contrib-python
8
+ pillow
@@ -0,0 +1,47 @@
1
+ -----------------------------------------------------------------------
2
+ DVR-Scan License (BSD 2-Clause)
3
+ < https://github.com/Breakthrough/DVR-Scan >
4
+ -----------------------------------------------------------------------
5
+
6
+ Copyright (C) 2016, Brandon Castellano.
7
+ All rights reserved.
8
+
9
+ Redistribution and use in source and binary forms, with or without
10
+ modification, are permitted provided that the following conditions
11
+ are met:
12
+
13
+ 1. Redistributions of source code must retain the above copyright
14
+ notice, this list of conditions and the following disclaimer.
15
+
16
+ 2. Redistributions in binary form must reproduce the above
17
+ copyright notice, this list of conditions and the following
18
+ disclaimer in the documentation and/or other materials
19
+ provided with the distribution.
20
+
21
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22
+ "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23
+ LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
24
+ A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
25
+ HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
26
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
27
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28
+ DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29
+ THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30
+ (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
31
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32
+
33
+ -----------------------------------------------------------------------
34
+ Ancillary Software Licenses
35
+ -----------------------------------------------------------------------
36
+
37
+ DVR-Scan uses the following third-party software components:
38
+
39
+ > NumPy [Copyright (C) 2005-2022, Numpy Developers]
40
+ > OpenCV [Copyright (C) 2022, OpenCV Team]
41
+ > FFmpeg [Copyright (C) 2001, Fabrice Bellard]
42
+ > CUDA [Copyright (C) 2020, Nvidia Corporation]
43
+
44
+ Some binary distributions may redistribute these components. See the
45
+ included LICENSE-THIRDPARTY file for details. By downloading, copying,
46
+ or using this software, you agree to the terms of this license and all
47
+ third-party software licenses.
@@ -0,0 +1,119 @@
1
+ Metadata-Version: 2.4
2
+ Name: DVR-Scan-Headless
3
+ Version: 1.8
4
+ Summary: Tool for finding and extracting motion events in video files (e.g. security camera footage).
5
+ Home-page: https://www.dvr-scan.com/
6
+ Author: Brandon Castellano
7
+ Author-email: brandon248@gmail.com
8
+ License: BSD 2-Clause License
9
+ Project-URL: Homepage, https://www.dvr-scan.com/
10
+ Project-URL: Repository, https://github.com/Breakthrough/DVR-Scan
11
+ Project-URL: Documentation, https://www.dvr-scan.com/docs
12
+ Project-URL: Bug Tracker, https://github.com/Breakthrough/DVR-Scan/issues
13
+ Keywords: video computer-vision analysis
14
+ Classifier: Development Status :: 5 - Production/Stable
15
+ Classifier: Environment :: Console
16
+ Classifier: Environment :: Console :: Curses
17
+ Classifier: Intended Audience :: Developers
18
+ Classifier: Intended Audience :: End Users/Desktop
19
+ Classifier: Intended Audience :: System Administrators
20
+ Classifier: License :: OSI Approved :: MIT License
21
+ Classifier: Operating System :: OS Independent
22
+ Classifier: Programming Language :: Python :: 3
23
+ Classifier: Programming Language :: Python :: 3.9
24
+ Classifier: Programming Language :: Python :: 3.10
25
+ Classifier: Programming Language :: Python :: 3.11
26
+ Classifier: Programming Language :: Python :: 3.12
27
+ Classifier: Programming Language :: Python :: 3.13
28
+ Classifier: Topic :: Multimedia :: Video
29
+ Classifier: Topic :: Multimedia :: Video :: Conversion
30
+ Classifier: Topic :: Multimedia :: Video :: Non-Linear Editor
31
+ Classifier: Topic :: Utilities
32
+ Requires-Python: >=3.9
33
+ Description-Content-Type: text/x-rst
34
+ License-File: LICENSE
35
+ Requires-Dist: numpy
36
+ Requires-Dist: platformdirs
37
+ Requires-Dist: scenedetect
38
+ Requires-Dist: screeninfo
39
+ Requires-Dist: tqdm
40
+ Requires-Dist: opencv-python
41
+ Requires-Dist: opencv-contrib-python
42
+ Requires-Dist: pillow
43
+ Dynamic: license-file
44
+
45
+
46
+ DVR-Scan
47
+ ==========================================================
48
+
49
+ Video Motion Event Detection and Extraction Tool
50
+ ----------------------------------------------------------
51
+
52
+ .. image:: https://img.shields.io/github/actions/workflow/status/Breakthrough/DVR-Scan/build.yml
53
+ :target: https://github.com/Breakthrough/DVR-Scan/actions
54
+
55
+ .. image:: https://img.shields.io/github/release/Breakthrough/DVR-Scan.svg
56
+ :target: https://github.com/Breakthrough/DVR-Scan
57
+
58
+ .. image:: https://img.shields.io/pypi/status/dvr-scan.svg
59
+ :target: https://github.com/Breakthrough/DVR-Scan
60
+
61
+ .. image:: https://raster.shields.io/pypi/l/dvr-scan.png
62
+ :target: http://pyscenedetect.readthedocs.org/en/latest/copyright/
63
+
64
+ .. image:: https://img.shields.io/github/stars/Breakthrough/DVR-Scan.svg?style=social&label=View%20on%20Github
65
+ :target: https://github.com/Breakthrough/DVR-Scan
66
+
67
+ ----------------------------------------------------------
68
+
69
+ Website: http://www.dvr-scan.com/
70
+
71
+ Documentation: http://dvr-scan.readthedocs.org/
72
+
73
+ Github: https://github.com/Breakthrough/DVR-Scan/
74
+
75
+
76
+ 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.
77
+
78
+ Quickstart
79
+ ----------------------------------------------------------
80
+
81
+ Install using ``pip``:
82
+
83
+ pip install --upgrade dvr-scan[opencv]
84
+
85
+ Scan ``video.mp4`` (separate clips for each event)::
86
+
87
+ dvr-scan -i video.mp4
88
+
89
+ Only scan a region of interest (`see user guide <http://www.dvr-scan.com/guide/>`_ or hit `H` for controls)::
90
+
91
+ dvr-scan -i video.mp4 -r
92
+
93
+ .. image:: https://raw.githubusercontent.com/Breakthrough/DVR-Scan/releases/1.6/docs/assets/region-editor-mask.jpg
94
+ :width: 480
95
+ :alt: overlay example
96
+
97
+ Draw boxes around motion::
98
+
99
+ dvr-scan -i video.mp4 -bb
100
+
101
+ .. image:: https://raw.githubusercontent.com/Breakthrough/DVR-Scan/releases/1.6/docs/assets/bounding-box.gif
102
+ :width: 480
103
+ :alt: overlay example
104
+
105
+ Use ``ffmpeg`` to extract events::
106
+
107
+ dvr-scan -i video.mp4 -m ffmpeg
108
+
109
+ For help or other issues, feel free to submit any bugs or feature requests to Github:
110
+
111
+ https://github.com/Breakthrough/DVR-Scan/issues
112
+
113
+ ----------------------------------------------------------
114
+
115
+ Licensed under BSD 2-Clause (see the ``LICENSE`` file for details).
116
+
117
+ Copyright (C) 2016 Brandon Castellano.
118
+ All rights reserved.
119
+
@@ -0,0 +1,66 @@
1
+ ![DVR-Scan Logo](https://raw.githubusercontent.com/Breakthrough/DVR-Scan/main/docs/assets/dvr-scan-logo.png)
2
+
3
+ :vhs: Find and extract motion events in videos.
4
+
5
+ ------------------------------------------------
6
+
7
+ ### Latest Release: v1.8 (August 23, 2025)
8
+
9
+ **Website**: [dvr-scan.com](https://www.dvr-scan.com)
10
+
11
+ **User Guide**: [dvr-scan.com/guide](https://www.dvr-scan.com/guide/)
12
+
13
+ **Documentation**: [dvr-scan.com/docs](https://www.dvr-scan.com/docs/)
14
+
15
+ **Discord**: [discord.gg/69kf6f2Exb](https://discord.gg/69kf6f2Exb)
16
+
17
+ ------------------------------------------------------
18
+
19
+ 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.
20
+
21
+ ## Quick Install
22
+
23
+ pip install dvr-scan --upgrade
24
+
25
+ Windows builds (installer + portable) are also available on [the Downloads page](https://www.dvr-scan.com/download/).
26
+
27
+ ## Quickstart (UI)
28
+
29
+ Start DVR-Scan (run `dvr-scan-app` or click the app shortcut), **Add** your input videos, and hit **Start**:
30
+
31
+ <img alt="main app window" src="https://raw.githubusercontent.com/Breakthrough/DVR-Scan/releases/1.8/docs/assets/app-main-window.jpg" width="480"/>
32
+
33
+ See the [User Guide](https://www.dvr-scan.com/guide/) for a more comprehensive overview.
34
+
35
+ ## Quickstart (CLI)
36
+
37
+ Scan `video.mp4` (separate clips for each event):
38
+
39
+ dvr-scan -i video.mp4
40
+
41
+ Select a region to scan using [the region editor](https://www.dvr-scan.com/guide/):
42
+
43
+ dvr-scan -i video.mp4 -r
44
+
45
+ <img alt="example of region editor" src="https://raw.githubusercontent.com/Breakthrough/DVR-Scan/releases/1.8/docs/assets/region-editor-mask.jpg" width="480"/>
46
+
47
+ Select a region to scan using command line (list of points as X Y):
48
+
49
+ dvr-scan -i video.mp4 -a 50 50 100 50 100 100 100 50
50
+
51
+ Draw boxes around motion:
52
+
53
+ dvr-scan -i video.mp4 -bb
54
+
55
+ <img alt="example of bounding boxes" src="https://raw.githubusercontent.com/Breakthrough/DVR-Scan/releases/1.8/docs/assets/bounding-box.gif" width="480"/>
56
+
57
+ Use `ffmpeg` to extract events:
58
+
59
+ dvr-scan -i video.mp4 -m ffmpeg
60
+
61
+ See [the documentation](https://www.dvr-scan.com/docs) 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](https://www.dvr-scan.com/docs/#config-file).
62
+
63
+ ------------------------------------------------
64
+
65
+ Copyright © 2016-2025 Brandon Castellano. All rights reserved.
66
+ Licensed under BSD 2-Clause (see the LICENSE file for details).
@@ -0,0 +1,75 @@
1
+
2
+ DVR-Scan
3
+ ==========================================================
4
+
5
+ Video Motion Event Detection and Extraction Tool
6
+ ----------------------------------------------------------
7
+
8
+ .. image:: https://img.shields.io/github/actions/workflow/status/Breakthrough/DVR-Scan/build.yml
9
+ :target: https://github.com/Breakthrough/DVR-Scan/actions
10
+
11
+ .. image:: https://img.shields.io/github/release/Breakthrough/DVR-Scan.svg
12
+ :target: https://github.com/Breakthrough/DVR-Scan
13
+
14
+ .. image:: https://img.shields.io/pypi/status/dvr-scan.svg
15
+ :target: https://github.com/Breakthrough/DVR-Scan
16
+
17
+ .. image:: https://raster.shields.io/pypi/l/dvr-scan.png
18
+ :target: http://pyscenedetect.readthedocs.org/en/latest/copyright/
19
+
20
+ .. image:: https://img.shields.io/github/stars/Breakthrough/DVR-Scan.svg?style=social&label=View%20on%20Github
21
+ :target: https://github.com/Breakthrough/DVR-Scan
22
+
23
+ ----------------------------------------------------------
24
+
25
+ Website: http://www.dvr-scan.com/
26
+
27
+ Documentation: http://dvr-scan.readthedocs.org/
28
+
29
+ Github: https://github.com/Breakthrough/DVR-Scan/
30
+
31
+
32
+ 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.
33
+
34
+ Quickstart
35
+ ----------------------------------------------------------
36
+
37
+ Install using ``pip``:
38
+
39
+ pip install --upgrade dvr-scan[opencv]
40
+
41
+ Scan ``video.mp4`` (separate clips for each event)::
42
+
43
+ dvr-scan -i video.mp4
44
+
45
+ Only scan a region of interest (`see user guide <http://www.dvr-scan.com/guide/>`_ or hit `H` for controls)::
46
+
47
+ dvr-scan -i video.mp4 -r
48
+
49
+ .. image:: https://raw.githubusercontent.com/Breakthrough/DVR-Scan/releases/1.6/docs/assets/region-editor-mask.jpg
50
+ :width: 480
51
+ :alt: overlay example
52
+
53
+ Draw boxes around motion::
54
+
55
+ dvr-scan -i video.mp4 -bb
56
+
57
+ .. image:: https://raw.githubusercontent.com/Breakthrough/DVR-Scan/releases/1.6/docs/assets/bounding-box.gif
58
+ :width: 480
59
+ :alt: overlay example
60
+
61
+ Use ``ffmpeg`` to extract events::
62
+
63
+ dvr-scan -i video.mp4 -m ffmpeg
64
+
65
+ For help or other issues, feel free to submit any bugs or feature requests to Github:
66
+
67
+ https://github.com/Breakthrough/DVR-Scan/issues
68
+
69
+ ----------------------------------------------------------
70
+
71
+ Licensed under BSD 2-Clause (see the ``LICENSE`` file for details).
72
+
73
+ Copyright (C) 2016 Brandon Castellano.
74
+ All rights reserved.
75
+