Frequently Asked Questions

How can I fix ImportError: No module named cv2?

You need to install OpenCV for PySceneDetect to properly work. If you're using pip, you can install it as follows:

pip install scenedetect[opencv]

Note that you may need to use a different/older version depending on your Python version. You can also use the headless package if you're running a server:

pip install scenedetect[opencv-headless]

Unlike calling pip install opencv-python, the above commands will download and install the correct OpenCV version based on the Python version you are running.

How can I enable video splitting support?

To enable video splitting support, you will also need to have mkvmerge or ffmpeg installed on your system. See the documentation on Video Splitting Support after installation for details.

How can I fix the error Cannot split video due to too many scenes?

This error occurs on Windows platforms specifically when the number of detected scenes is too large. This is because PySceneDetect internally invokes other commands, such as those used for the split-video command.

You can get around this issue by simply invoking those tools manually, using a smaller sub-set of scenes (or splitting the scene list into multiple parts). You can obtain a comma-separated list of timecodes by using the list-scenes command.

See Issue #164 for details, or if you have any further questions.

How can I fix the error Failed to read any frames from video file?

Unfortunately, the underlying library used to perform video I/O was unable to open the file. This occasionally happens due to videos having multiple audio tracks (as per #179).

As a workaround, you can remove the audio track using either ffmpeg or mkvmerge as follows:

ffmpeg -i input.mp4 -c copy -an output.mp4


mkvmerge -o output.mkv input.mp4