Minor release including only additions and bugfixes (thanks to everyone who contributed to this release!). Changelog:

• [enhancement] --min-duration now accepts a timecode in addition to frame number (#128, thanks @tonycpsu)
• [feature] Add --image-frame-margin option to save-images command to ignore a number of frames at the start/end of a scene (#129, thanks @tonycpsu)
• [bugfix] --min-scene-len option was not respected by first scene (#105, thanks @charlesvestal)
• [bugfix] Splitting videos with an analyzed duration only splits within analyzed area (#106, thanks @charlesvestal)
• [bugfix] Improper start timecode applied to the split-video command when using ffmpeg (#93, thanks @typoman)
• [bugfix] Added links and filename sanitation to html output (#139 and #140, thanks @wsj018)
• [bugfix] UnboundLocalError in detect_scenes when frame_skip is larger than 0 (#126, thanks @twostarxx)

• minor re-release of v0.5.1, includes updated setup.py which returns OpenCV to an optional dependency

• to install from pip now with all dependencies:

  pip install scenedetect[opencv,progress_bar]

• to install only PySceneDetect: (separate OpenCV installation required)

  pip install scenedetect

• the release notes of v0.5.1 have been modified to include the prior command

• no change to PySceneDetect program version

• [feature] add get_duration method to VideoManager (#109, thanks @arianaa30)

This change was made to support platforms where the opencv-python package is unavailable, and to allow using a non-pip version of OpenCV (e.g. a binary install or building from source). See #73 for why the original fix was implemented, and #111 for details on what prompted this re-release.

• [feature] Add new export-html command to the CLI (thanks @wjs018)
• [bugfix] VideoManager read function failed on multiple videos (thanks @ivan23kor)
• [bugfix] Fix crash when no scenes are detected (#79, thanks @raj6996)
• [bugfix] Fixed OpenCV not getting installed due to missing dependency (#73)
• [enhance] When no scenes are detected, the whole video is now returned instead of nothing (thanks @piercus)
• Removed Windows installer due to binary packages now being available, and to streamline the release process (see #102 for more information). When you type pip install scenedetect[opencv,progress_bar], all dependencies will be installed.

You can install via pip:

pip install scenedetect

There is now a manual published at manual.scenedetect.com. See the main project page for details on installing dependencies.

The Windows build should be released within a week or so.

Changelog

• major release, includes stable Python API with examples and updated documentation
• numerous changes to command-line interface with addition of sub-commands (see the new manual for updated usage information)
• [feature] videos are now split using ffmpeg by default, resulting in frame-perfect cuts (can still use mkvmerge by specifying the -c/--copy argument to the split-video command)
• [enhance] image filename numbers are now consistent with those of split video scenes (PR #39, thanks @e271828-)
• [enhance] 5-10% improvement in processing performance due to reduced memory copy operations (PR #40, thanks [@elcombato] (#40))
• [enhance] updated exception handling to raise proper standard exceptions (PR #37, thanks @talkain)
• several fixes to the documentation, including improper dates and outdated CLI arguments (PR #26 and #, thanks [@elcombato] (#26), and @colelawrence)
• numerous other PRs and issues/bug reports that have been fixed - there are too many to list individually here, so I want to extend a big thank you to everyone who contributed to making this release better
• [enhance] add Sphinx-generated API documentation (available at: http://manual.scenedetect.com)
• [project] move from BSD 2-clause to 3-clause license

This latest release includes integrated video splitting via mkvmerge if installed on the system (included with Windows builds). Note, this update changes the behaviour of the -o / --output option. Overview of changes:

• specifying -o OUTPUT_FILE.mkv will now automatically split the input video, generating a new video clip for each detected scene in sequence, starting with OUTPUT_FILE-001.mkv
• CSV file output is now specified with the -co / --csv-output option (note, used to be -o in versions of PySceneDetect < 0.4)

The specific components distributed with the Windows binaries are Python 3.4.4, OpenCV 3.1.0, Numpy 1.11.2, and mkvmerge 9.7.1.

This release includes some performance improvements, internal application structure changes, and a new lightweight installer for Windows that doesn't require an existing Python environment (a portable version is also available). The recommended installation method for Linux and Mac users is to download the source distribution and run sudo setup.py install in the location of the extracted files (once you have installed the prerequisite OpenCV and Numpy packages for Python).

• [enhance] speed improvement when using --frameskip option
• [internal] moved application state and shared objects to a consistent interface (the SceneManager object) to greatly reduce the number of required arguments for certain API functions
• [enhance] added installer for Windows builds (64-bit only currently)

The specific components distributed with the Windows binaries are Python 3.4.4, OpenCV 3.1.0, and Numpy 1.11.2.

This release includes some minor bug-fixes, as well as includes a portable build for 64-bit Windows users that don't want to install a Python environment (download PySceneDetect-XYZ-win64.zip and run scenedetect.exe from a command prompt; note you may need to add the folder to your %PATH% variable manually.).

• [enhance] initial release of portable build for Windows (64-bit only), including all dependencies
• [bugfix] fix unrelated exception thrown when video could not be loaded
• [internal] fix variable name typo in API documentation

The specific components distributed with the Windows binaries are Python 3.4.4, OpenCV 3.1.0, and Numpy 1.11.2.