Skip to main content

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

Project description

https://readthedocs.org/projects/pyscenedetect/badge/?version=latest 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, written in Python and using OpenCV, which analyzes a video, looking for scene changes or cuts. The output timecodes can then be used with another tool (e.g. mkvmerge, ffmpeg) to split the video into individual clips (or using the split-video command). A frame-by-frame analysis can also be generated for a video, 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) 2012-2019 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.1.1.tar.gz (60.5 kB view details)

Uploaded Source

Built Distributions

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

scenedetect-0.5.1.1-py3-none-any.whl (76.0 kB view details)

Uploaded Python 3

scenedetect-0.5.1.1-py2-none-any.whl (76.0 kB view details)

Uploaded Python 2

File details

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

File metadata

  • Download URL: scenedetect-0.5.1.1.tar.gz
  • Upload date:
  • Size: 60.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/3.6.6

File hashes

Hashes for scenedetect-0.5.1.1.tar.gz
Algorithm Hash digest
SHA256 16526b5c1c1eca0fd060571b62f979a3a2b9a0c47a76edffcde56099cf1efe24
MD5 502bfedc32c6b05aa35ac018485d56a9
BLAKE2b-256 04de8b19c0247b88041bc1c8e1609bfa0af9410fc4eddd44e32afa29ad1146d0

See more details on using hashes here.

File details

Details for the file scenedetect-0.5.1.1-py3-none-any.whl.

File metadata

  • Download URL: scenedetect-0.5.1.1-py3-none-any.whl
  • Upload date:
  • Size: 76.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/3.6.6

File hashes

Hashes for scenedetect-0.5.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 75174707569d1f1e1347f0c96576cc1ada6f1a2ba5958f6b3068209a36c3e030
MD5 5219a57d04c7d19250afab80b7294de9
BLAKE2b-256 2dbe773bdc97a82131409b1b3f2a526b93ca37b303cd8623a47a967b4dfb40e7

See more details on using hashes here.

File details

Details for the file scenedetect-0.5.1.1-py2-none-any.whl.

File metadata

  • Download URL: scenedetect-0.5.1.1-py2-none-any.whl
  • Upload date:
  • Size: 76.0 kB
  • Tags: Python 2
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/3.6.6

File hashes

Hashes for scenedetect-0.5.1.1-py2-none-any.whl
Algorithm Hash digest
SHA256 94fc6d0349f7032b142bbfe562855aa69b2cc09faea3c56e5c7bdeb210e4651c
MD5 68268d66e0a29adb33ee7fc43b7da54a
BLAKE2b-256 56f5f236c19a47de13ff28a01ac959c7f7666589cc0b4ec2d3ca8f0282695d13

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