After installation, you can run DVR-Scan from any terminal/command prompt by typing dvr-scan (try running dvr-scan --version to verify that everything was installed correctly). If using a portable distribution on Windows, you need to run the program from the folder containing the dvr-scan.exe file, unless you add the folder to your system's %PATH% variable. You do not need to do this if you used the .MSI installer.


Installation from Source (all platforms)

Start by downloading the latest release of DVR-Scan and extracting it to a location of your choice. Make sure you have the appropriate system requirements installed before continuing. DVR-Scan requires Python, Numpy, and OpenCV to function correctly.

Installing Dependencies

If installing from source, DVR-Scan requires Python 2 or 3 (tested on 3.X, untested but should work on 2.X) and the following libraries (quick install guide):

  • OpenCV (requires version 3.0 and above) and the Python module (cv2)
  • Numpy Python module (numpy)
  • tqdm, optional Python module (tqdm) for displaying progress bar and estimated time remaining

You can click here for a quick guide (OpenCV + Numpy on Windows & Linux) on installing the latest versions of OpenCV/Numpy on Windows (using pre-built binaries) and Linux (compiling from source). If the Python module that comes with OpenCV on Windows is incompatible with your system architecture or Python version, see this page to obtain a pre-compiled (unofficial) module.

Note that some Linux package managers still provide older, dated builds of OpenCV (pre-3.0); if you want to ensure you have the latest version, it's recommended that you build and install OpenCV from source on Linux.

Installing DVR-Scan

To ensure you have all the requirements installed, open a python interpreter, and ensure you can run import numpy and import cv2 without any errors (optionally, if you installed tqdm, run import tqdm as well).

DVR-Scan can then be installed by running the following command in the location of the extracted files:

sudo python setup.py install

Once finished, DVR-Scan will be installed, and you should be able to run the dvr-scan command from any terminal/command prompt. To verify that everything was installed properly, try calling the following command:

dvr-scan --version

To get familiar with DVR-Scan, try running dvr-scan --help, or see the Getting Started & Examples section. If you encounter any runtime errors while running DVR-Scan, ensure that you have all the required dependencies listed in the System Requirements section above (again, you should be able to import numpy and import cv2, and optionally, import tqdm if tqdm was installed).


Updating DVR-Scan

To update DVR-Scan when newer versions are released, follow the instructions for your installation method again. You do not need to uninstall or remove any older versions of DVR-Scan when upgrading.

If using the MSI installer, older versions of DVR-Scan will be upgraded automatically. If using a portable distribution, you can safely overwrite any existing files with the ones included with the new version. If installing from source, running the installation command will automatially upgrade the existing DVR-Scan installation on the system.