scenedetect 🎬 Module


The scenedetect module is organized into several sub-modules, each containing the implementation of a particular class. The most commonly used classes are available for import directly from the scenedetect module (see the Example below). The following is an overview of the main classes/modules provided in the scenedetect package:

Note that every module has the same name of the implemented class in lowercase_underscore format, whereas the class name itself is in PascalCase format. There are also some constants, functions, and exceptions defined in various modules that are documented in the section describing the associated class.


In the code example below, we create a function find_scenes() which will load a video, detect the scenes, and return a list of tuples containing the (start, end) timecodes of each detected scene. Note that you can modify the threshold argument to modify the sensitivity of the ContentDetector.

# Standard PySceneDetect imports:
from scenedetect import VideoManager
from scenedetect import SceneManager

# For content-aware scene detection:
from scenedetect.detectors import ContentDetector

def find_scenes(video_path, threshold=30.0):
    # Create our video & scene managers, then add the detector.
    video_manager = VideoManager([video_path])
    scene_manager = SceneManager()

    # Base timestamp at frame 0 (required to obtain the scene list).
    base_timecode = video_manager.get_base_timecode()

    # Improve processing speed by downscaling before processing.

    # Start the video manager and perform the scene detection.

    # Each returned scene is a tuple of the (start, end) timecode.
    return scene_manager.get_scene_list(base_timecode)

To get started, try printing the return value of find_scenes on a small video clip:

scenes = find_scenes('video.mp4')

For a more advanced example of using the PySceneDetect API to with a stats file (to speed up processing of the same file multiple times), take a look at the example in the SceneManager reference.