Overview of Features
Content-Aware Scene DetectionDetects breaks in-between content, not only when the video fades to black (although a threshold mode is available as well for those cases).
Compatible With Many External ToolsThe detected scene boundaries/cuts can be exported in a variety of formats, with the default type (comma-separated HH:MM:SS.nnn values) being ready to copy-and-paste directly into other tools (such as ffmpeg, mkvmerge, etc...) for splitting and/or re-encoding the video.
Statistical Video AnalysisCan output a spreadsheet-compatible file for analyzing trends in a particular video file, to determine the optimal threshold values to use with specific scene detection methods/algorithms.
Extendible and EmbeddableWritten in Python, and designed with an easy-to-use and extendable API, PySceneDetect is ideal for embedding into other programs, or to implement custom methods/algorithms of scene detection for specific applications (e.g. analyzing security camera footage).
Features in Current Release
- exports list of scenes to .CSV file (both timecodes and frame numbers) (
- exports timecodes in mkvmerge format: HH:MM:SS.nnnnn, comma-separated
- statistics/analysis mode to export frame-by-frame video metrics (
- output-suppression (quiet) mode for better automation with external scripts/programs
- user-selectable subsampling for improved performance (
- user-selectable frame skipping for improved performance (
- save an image of the first and last frame of each detected scene (
- ability to specify starting/ending times (
-et), and/or set duration for processing (
- user-definable fade bias (
-fb) to shift scenes between fade in/out points (threshold mode only)
List of Scene Detection Methods
- threshold scene detection (
-d threshold): analyzes video for changes in average frame intensity/brightness
- content-aware scene detection (
-d content): based on changes between frames in the HSV color space
For a detailed explanation of how a particular scene detection method/algorithm works, see the Scene Detection Method Details Section in the Documentation & Reference.
Features in Development for Next Version
The following are features being planned or developed after the release of v0.3.5:
- additional timecode formats
- adaptive bias for fade in/out interpolation
- multithreaded implementation of detection algorithms for improved performance
Planned Features for Future Releases
The following are features being planned or developed for future releases of PySceneDetect (v0.4 and onwards):
- export scenes in chapter/XML format
- improve robustness of content-aware detection by combining with edge detection (similar to MATLAB-based scene change detector)
- automatic threshold detection for the current scene detection methods (can be done in pre-pass if necessary)
- standalone distribution/build for Windows (x86/64)
- GUI for easier previewing and threshold setting (will be GTK+ 3 based via PyGObject)