Scenedetect

Release Notes

* One of the last major updates before transitioning to the new v1.0.x API
* The `--min-scene-len`/`-m` option is now global rather than per-detector
* There is a new global option `--drop-short-scenes` to go along with `-m`
* Removed first row from statsfiles so it is a valid CSV file
* The progress bar now correctly resizes when the terminal is resized
* Image sequences and URLs are now supported for input via the CLI/API
* Images exported using the `save-images` command are now resized to match the display aspect ratio
* A new flag `-s`/`--skip-cuts` has been added to the `list-scenes` command to allow standardized processing
* The functionality of `save-images` is now accessible via the Python API through the `save_images()` function in `scenedetect.scene_manager`
* Under the `save-images` command, renamed `--image-frame-margin` to `--frame-margin`, added short option `-m`, and increased the default value from 0 to 1 due to instances of the last frame of a video being occasionally missed (set `-m 0` to restore original behaviour)

Changelog

Full changelog can be found [here on Github](https://github.com/Breakthrough/PySceneDetect/blob/master/docs/changelog.md#055-january-17-2021-).

Known Issues

* Image sequences or URL inputs are not supported by the `save-images` or `split-video` commands
* Variable framerate videos (VFR) are not fully supported, and will yield incorrect timestamps ([168](https://github.com/Breakthrough/PySceneDetect/issues/168))

Release Notes

* Improved performance when using `time` and `save-images` commands
* Improved performance of `detect-threshold` when using a small minimum percent
* Fix crash when using `detect-threshold` with a statsfile
* Fix crash when using `save-images` command under Python 2.7
* Support for Python 3.3 and 3.4 has been deprecated (see below)
* Version number on PyPI for this release is v0.5.4.1

Changelog

Full changelog can be found [here on Github](https://github.com/Breakthrough/PySceneDetect/blob/master/docs/changelog.md#054-september-14-2020).

Known Issues

* Variable framerate videos are not supported properly currently (168), a warning may be added in the next release to indicate when a VFR video is detected, until this can be properly resolved ([168](https://github.com/Breakthrough/PySceneDetect/issues/168))
* In certain cases, video files which will not load will fail silently, with PySceneDetect reporting that it processed 0 frames. Better error handling/messaging is planned for these cases as part of [179](https://github.com/Breakthrough/PySceneDetect/issues/179)

Release Notes
* Resolved long-standing bug where `split-video` command would duplicate certain frames at the beginning/end of the output ([93](https://github.com/Breakthrough/PySceneDetect/issues/93))
* This was determined to be caused by copying (instead of re-encoding) the audio track, causing extra frames to be brought in when the audio samples did not line up on a frame boundary (thank you joshcoales for your assistance)
* Default behavior is to now re-encode audio tracks using the `aac` codec when using `split-video` (it can be overriden in both the command line and Python interface)
* Improved timestamp accuracy when using `split-video` command to further reduce instances of duplicated or off-by-one frame issues
* Fixed application crash when using the `-l`/`--logfile` argument

Changelog

Full changelog can be found [here on Github](https://github.com/Breakthrough/PySceneDetect/blob/master/docs/changelog.md#053-july-12-2020).

Known Issues

* Seeking through long videos is inefficient, causing the `time` and `save-images` command to take a long time to run. This will be resolved in the next release (see [98](https://github.com/Breakthrough/PySceneDetect/issues/98))
* The `save-images` command causes PySceneDetect to crash under Python 2.7 (see [174](https://github.com/Breakthrough/PySceneDetect/issues/174))
* Using `detect-threshold` with a statsfile causes PySceneDetect to crash (see [122](https://github.com/Breakthrough/PySceneDetect/issues/122))
* Variable framerate videos are not supported properly currently (168), a warning may be added in the next release to indicate when a VFR video is detected, until this can be properly resolved ([168](https://github.com/Breakthrough/PySceneDetect/issues/168))
* Videos with multiple audio tracks may not work correctly, see [this comment on 179](https://github.com/Breakthrough/PySceneDetect/issues/179#issuecomment-685252441) for a workaround using `ffmpeg` or `mkvmerge`

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](https://github.com/Breakthrough/PySceneDetect/pull/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](https://github.com/Breakthrough/PySceneDetect/pull/129), thanks tonycpsu)
* [bugfix] `--min-scene-len` option was not respected by first scene ([105](https://github.com/Breakthrough/PySceneDetect/issues/105), thanks charlesvestal)
* [bugfix] Splitting videos with an analyzed duration only splits within analyzed area ([106](https://github.com/Breakthrough/PySceneDetect/issues/106), thanks charlesvestal)
* [bugfix] Improper start timecode applied to the `split-video` command when using `ffmpeg` ([93](https://github.com/Breakthrough/PySceneDetect/issues/93), thanks typoman)
* [bugfix] Added links and filename sanitation to html output ([139](https://github.com/Breakthrough/PySceneDetect/issues/139) and [#140](https://github.com/Breakthrough/PySceneDetect/issues/140), thanks wsj018)
* [bugfix] UnboundLocalError in `detect_scenes` when `frame_skip` is larger than 0 ([126](https://github.com/Breakthrough/PySceneDetect/issues/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](https://github.com/Breakthrough/PySceneDetect/issues/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](https://github.com/Breakthrough/PySceneDetect/pull/104))
* [bugfix] VideoManager read function failed on multiple videos (thanks [ivan23kor](https://github.com/Breakthrough/PySceneDetect/pull/107))
* [bugfix] Fix crash when no scenes are detected ([79](https://github.com/Breakthrough/PySceneDetect/issues/79), thanks raj6996)
* [bugfix] Fixed OpenCV not getting installed due to missing dependency ([73](https://github.com/Breakthrough/PySceneDetect/issues/73))
* [enhance] When no scenes are detected, the whole video is now returned instead of nothing (thanks [piercus](https://github.com/Breakthrough/PySceneDetect/pull/89))
* Removed Windows installer due to binary packages now being available, and to streamline the release process (see [102](https://github.com/Breakthrough/PySceneDetect/issues/102) for more information). When you type `pip install scenedetect[opencv,progress_bar]`, all dependencies will be installed.