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.
- OpenCV (requires version 3.0 and above) and the Python module (
- Numpy Python module (
- 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.
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:
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).
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.