Skip to main content

A cross-platform, OpenCV-based video scene detection program and Python library.

Project description

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

Website: http://py.scenedetect.com/

Documentation: http://manual.scenedetect.com/

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


PySceneDetect is a command-line tool and Python library which analyzes a video, looking for scene changes or cuts. PySceneDetect integrates with external tools (e.g. mkvmerge, ffmpeg) to automatically split the video into individual clips when using the split-video command. A frame-by-frame analysis can also be generated for a video, called a stats file, to help with determining optimal threshold values or detecting patterns/other analysis methods for a particular video.

There are two main detection methods PySceneDetect uses: detect-threshold (comparing each frame to a set black level, useful for detecting cuts and fades to/from black), and detect-content (compares each frame sequentially looking for changes in content, useful for detecting fast cuts between video scenes, although slower to process). Each mode has slightly different parameters, and is described in detail in the documentation.

In general, use detect-threshold mode if you want to detect scene boundaries using fades/cuts in/out to black. If the video uses a lot of fast cuts between content, and has no well-defined scene boundaries, you should use the detect-content mode. Once you know what detection mode to use, you can try the parameters recommended below, or generate a statistics file (using the -s / –stats argument) in order to determine the correct paramters - specifically, the proper threshold value.

For help or other issues, feel free to submit any bugs or feature requests to Github: https://github.com/Breakthrough/PySceneDetect/issues


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

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scenedetect-0.5.6.1.tar.gz (70.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

scenedetect-0.5.6.1-py2.py3-none-any.whl (98.8 kB view details)

Uploaded Python 2Python 3

File details

Details for the file scenedetect-0.5.6.1.tar.gz.

File metadata

  • Download URL: scenedetect-0.5.6.1.tar.gz
  • Upload date:
  • Size: 70.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.7.9

File hashes

Hashes for scenedetect-0.5.6.1.tar.gz
Algorithm Hash digest
SHA256 dc25ada3ee8c77097ae78eca068d38c1e9826c52e49dbc753d5bc234a8efe8a3
MD5 5fe694ac90e983b4de7b6ae16b294db7
BLAKE2b-256 51e4df2dc0b70f55822c9a80f30b30b2cfac470160c3836534de019fa8d32821

See more details on using hashes here.

File details

Details for the file scenedetect-0.5.6.1-py2.py3-none-any.whl.

File metadata

  • Download URL: scenedetect-0.5.6.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 98.8 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.7.9

File hashes

Hashes for scenedetect-0.5.6.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 b62fc4af18e2e2e34e3af94b8bc1e37eb4b6e0b3c2c4f4058fa7fc6a6714639b
MD5 59b3f78f66e0f749cdb8ada081a98c67
BLAKE2b-256 d7ea51929b095c8d10a188f3ef6872dda8950c64ae820c56edf82ba122841868

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page