PySceneDetect is completely free software, and can be downloaded from the links below. See the license and copyright information page for details. If you have trouble running PySceneDetect, ensure that you have all the required dependencies listed in the Dependencies section below.
PySceneDetect requires at least Python 3.6 or higher.
Download and Installation
Install via pip
Including OpenCV (recommended):
pip install --upgrade scenedetect[opencv]
Including Headless OpenCV (servers):
pip install --upgrade scenedetect[opencv-headless]
PySceneDetect is available via
pip as the
Windows Build (64-bit Only)
Latest Release: v0.6
Release Date: May 29, 2022Installer (recommended) Portable .zip Getting Started
After installation, you can call PySceneDetect from any terminal/command prompt by typing
scenedetect (try running
scenedetect help, or
To get familiar with PySceneDetect, try running
scenedetect help, or continue onwards to the Getting Started: Basic Usage section. If you encounter any runtime errors while running PySceneDetect, ensure that you have all the required dependencies listed in the System Requirements section above (you should be able to
import numpy and
import cv2). If you encounter any issues or want to make a feature request, feel free to report any bugs or share some feature requests/ideas on the issue tracker and help make PySceneDetect even better.
PySceneDetect requires Python 3 and the following packages:
pip install opencv-python
pip install numpy
pip install Click
pip install tqdm
pip install appdirs
pip install av
Video Splitting Tools
For video splitting support, you need to have one of the following tools available (included in Windows builds):
- ffmpeg, required to split video files (
- mkvmerge, part of mkvtoolnix, command-line tool, required to split video files in stream copy mode (
mkvmerge command must be available system wide (e.g. in a directory in
PATH, so it can be used from any terminal/console by typing the command), or alternatively, placed in the same directory where PySceneDetect is installed. On Windows this is usually
XY is your Python version.
If you have trouble getting PySceneDetect to find
mkvmerge, see the section on Manually Enabling
split-video Support on Getting Started: Video Splitting Support Requirements.
Building OpenCV from Source
If you have installed OpenCV using
pip, you will need to uninstall it before installing a different version of OpenCV, or building and installing it from source.
You can click here for a quick guide (OpenCV + Numpy on Windows & Linux) on installing 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.
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.