# breakthrough/pyscenedetect **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/breakthrough-pyscenedetect).** 4,556 stars · 474 forks · Python · bsd-3-clause ## Links - GitHub: https://github.com/Breakthrough/PySceneDetect - Homepage: https://www.scenedetect.com/ - awesome-repositories: https://awesome-repositories.com/repository/breakthrough-pyscenedetect.md ## Topics `analysis` `image-processing` `opencv` `python` `python-opencv` `scene-detection` `scene-recognition` `video` `video-processing` ## Description PySceneDetect is a suite of tools for identifying cuts and transitions in video files using content, threshold, and histogram detection algorithms. It functions as a scene detector, frame extractor, statistics analyzer, metadata exporter, and video scene splitter. The project identifies scene boundaries and can divide video files into smaller clips using external processing tools. It allows for the extraction of representative image frames from detected changes and the export of scene lists into industry-standard formats such as EDL, FCP, HTML, OTIO, and CSV. The toolset includes capabilities for per-frame metric tracking and visual pattern analysis to determine optimal detection thresholds. It provides an interface to ingest video content from local files, hardware cameras, or data pipes. ## Tags ### Graphics & Multimedia - [Automated Scene Detection](https://awesome-repositories.com/f/graphics-multimedia/automated-scene-detection.md) — Provides automated identification of cuts and transitions within video files using content and threshold analysis. - [Video File Processors](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/media-manipulation/media-processing/video-analysis-processing/video-file-processors.md) — Processes video files to divide them into smaller clips based on detected scene boundaries. - [Video Clip Extraction](https://awesome-repositories.com/f/graphics-multimedia/video-content-repurposing/video-clip-extraction.md) — Divides long video files into smaller clips based on detected scene boundaries. - [Video Frame Capture](https://awesome-repositories.com/f/graphics-multimedia/video-frame-capture.md) — Utilizes OpenCV to extract and save individual image frames from video streams for analysis. - [Video Transition Detection](https://awesome-repositories.com/f/graphics-multimedia/video-transition-detection.md) — Identifies cuts and transitions in video files using content, threshold, and histogram detection algorithms. ([source](https://cdn.jsdelivr.net/gh/breakthrough/pyscenedetect@main/README.md)) - [Frame Statistics Generation](https://awesome-repositories.com/f/graphics-multimedia/frame-statistics-generation.md) — Generates analysis files for each frame to determine optimal detection thresholds and identify recurring visual patterns. ([source](https://cdn.jsdelivr.net/gh/breakthrough/pyscenedetect@main/README.md)) - [Histogram Analysis](https://awesome-repositories.com/f/graphics-multimedia/image-editing-processing/image-analysis-tools/histogram-analysis.md) — Analyzes pixel intensity distributions via histograms to detect scene transitions. - [Lossless Video Splitting](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/media-manipulation/media-processing/video-analysis-processing/video-file-processors/video-dataset-processing/lossless-video-splitting.md) — Implements lossless video splitting by delegating the cutting process to external system tools. - [Scene List Exporters](https://awesome-repositories.com/f/graphics-multimedia/scene-list-exporters.md) — Writes detected scene boundaries to standard formats including EDL, FCP, HTML, OTIO, and CSV. ([source](https://www.scenedetect.com/docs/0.6.1/)) - [Video Project Metadata Exports](https://awesome-repositories.com/f/graphics-multimedia/video-converters/multi-format-exporters/multi-format-asset-exports/video-project-metadata-exports.md) — Generates scene lists in standard formats like EDL and CSV for synchronization with external editors. - [Video Frame Metric Analyzers](https://awesome-repositories.com/f/graphics-multimedia/video-frame-metric-analyzers.md) — Computes and stores per-frame metrics to determine optimal detection thresholds and visual patterns. - [Frame Metric Analysis](https://awesome-repositories.com/f/graphics-multimedia/video-frame-processing/frame-metric-analysis.md) — Provides per-frame metric tracking and statistical analysis to determine optimal scene detection thresholds. ([source](https://www.scenedetect.com/docs/0.6.3/)) - [Video Temporal Analysis](https://awesome-repositories.com/f/graphics-multimedia/video-temporal-analysis.md) — Computes per-frame statistics and visual patterns to analyze changes in video data across a timeline. ### Part of an Awesome List - [Video Search and Tools](https://awesome-repositories.com/f/awesome-lists/media/video-search-and-tools.md) — Functions as a specialized tool for analyzing video content to detect scenes and cuts. ### Development Tools & Productivity - [Scene-Based Modularity](https://awesome-repositories.com/f/development-tools-productivity/modular-architecture/scene-based-modularity.md) — Divides video files into separate clips based on detected scene boundaries. ([source](https://www.scenedetect.com/docs/0.7/)) ### Scientific & Mathematical Computing - [Frame Difference Thresholding](https://awesome-repositories.com/f/scientific-mathematical-computing/perceptual-color-difference-metrics/color-difference-thresholding/frame-difference-thresholding.md) — Identifies scene cuts by comparing frame-to-frame differences against defined mathematical limits. ### Artificial Intelligence & ML - [Representative Frame Sampling](https://awesome-repositories.com/f/artificial-intelligence-ml/sequence-modeling/temporal-sequence-processors/representative-frame-sampling.md) — Extracts representative frames from scene transitions to serve as visual markers or thumbnails. ### Data & Databases - [Metadata Export Formatters](https://awesome-repositories.com/f/data-databases/data-compression-algorithms/pluggable-architectures/metadata-export-formatters.md) — Provides pluggable formatters to export scene boundaries into industry-standard metadata formats like EDL and FCP.