Add chapters to video based on scene cuts
Project description
chaptinator
Add chapters on scene changes to videos (e.g. slide changes in presentations)
Install
chaptinator
requires ffmpeg
to be installed on your system and for it to
be in PATH
.
Follow the instructions on https://ffmpeg.org/ and make sure the commands
ffmpeg
and ffprobe
are available in your favorite shell (bash, zsh,
Powershell, ...).
Then install this package via pip. For a global installation use
sudo pip install chaptinator
and for a user-local installation use
pip install --user chaptinator
Usage
chaptinator VIDEO [-t TITLE] [-a AUTHOR] [-c CHANGE_THRESH] [-s] [-m METADATA_FILE]
-t TITLE
sets the title in the metadata (default: filename)
-a ARTIST
sets the artist in the metadata
-c CHANGE
"value between 0 and 1 to indicate a new scene; a low value
reflects a low probability for the current frame to introduce a new scene,
while a higher value means the current frame is more likely to be one"
-- https://ffmpeg.org/ffmpeg-filters.html#select_002c-aselect
-s
scales the tagged result video to a height 720 while keeping the aspect
ratio
-m METADATA_FILE
disables the cut detection and instead uses the provided
metadata file. This file has to have the structure described in
https://ffmpeg.org/ffmpeg-formats.html#Metadata-1
Example
# increase cut detection threshold to 0.4 and scale the video
chaptinator foo.mp4 -t "Video Title" -a "Author Name" -c 0.4 -s
# read cuts from metadata file
chaptinator foo.mp4 -m metadata.txt
Use Cases
chaptinator
could be used to add chapters to presentation slides that were
recorded in PowerPoint and exported as video.
But of course it works with any video file that has cuts in it, just adjust
the -c
parameter to your preference.
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
Built Distribution
Hashes for chaptinator-0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0f4a1a423c257cbf278854db7ece4f8e3afc4f59f08f348d96c78d23c3a3f490 |
|
MD5 | ef2ede400569bfe41c11a8970265c61d |
|
BLAKE2b-256 | e41c209246cb43e164957b2c60f5252f1c7de460f4bb1b2b2e8d381733bcd5f3 |