Skip to main content

PySceneDetect

Video Scene Cut Detection and Analysis Tool

https://img.shields.io/pypi/status/scenedetect.svg https://img.shields.io/github/release/Breakthrough/PySceneDetect.svg https://img.shields.io/pypi/l/scenedetect.svg https://img.shields.io/github/stars/Breakthrough/PySceneDetect.svg?style=social&label=View%20on%20Github

Documentation: https://www.scenedetect.com/docs

Github Repo: https://github.com/Breakthrough/PySceneDetect/

Install: pip install --upgrade scenedetect (or scenedetect-headless for servers)

Packages: scenedetect (CLI + opencv-python) and scenedetect-headless (CLI + opencv-python-headless). Both provide the same scenedetect module – install only one.


PySceneDetect is a tool for detecting shot changes in videos, and can automatically split videos into separate clips. PySceneDetect is free and open-source software, and has several detection methods to find fast-cuts and threshold-based fades.

For example, to split a video: scenedetect -i video.mp4 split-video

You can also use the Python API (docs) to do the same:

from scenedetect import detect, AdaptiveDetector, split_video_ffmpeg
scene_list = detect('my_video.mp4', AdaptiveDetector())
split_video_ffmpeg('my_video.mp4', scene_list)

Licensed under BSD 3-Clause (see the LICENSE file for details).

Copyright (C) 2014 Brandon Castellano. All rights reserved.

Metadata

Release files for scenedetect-headless 0.7.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for scenedetect-headless 0.7.2
File Size Uploaded
scenedetect_headless-0.7.2.tar.gz 274.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for scenedetect-headless 0.7.2
File Interpreter ABI Platform
scenedetect_headless-0.7.2-py3-none-any.whl Python 3 none any Details

Total release size: 424.5 kB

Release files / scenedetect_headless-0.7.2.tar.gz

Download URL scenedetect_headless-0.7.2.tar.gz
Size 274.7 kB
Tags Source
SHA-256 checksum
How to use checksums
7bea6a18f0e78c29e3759b367553482dd2b3dc194969609a1b7393670b95924a
BLAKE2b-256 checksum
How to use checksums
5d714cd85b61e3f79177c009aeecc1beb3d103fd89a33394db13ff79c9e5c90b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.

Transparency log

Release files / scenedetect_headless-0.7.2-py3-none-any.whl

Download URL scenedetect_headless-0.7.2-py3-none-any.whl
Size 149.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
583fd5dbc2418f027a1c17c3444d0bbd8cb630357e19705c4f68ae4c1aa51ef2
BLAKE2b-256 checksum
How to use checksums
e314727cbb58c72d6df4520153ea6788e1efdebb5d6b446392c784017c70ce0a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.7.2 This release

2 release files

0.7.1

2 release files

0.7

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page