Main documentation on Read the Docs: https://storyboard.readthedocs.io
Caution: Development has been deferred indefinitely as of July 23, 2015. However, contributions are welcome, and the maintainer will review pull requests in a timely manner.
storyboard is an FFmpeg-based customizable video storyboard generator with metadata reporting directly embedded in the generated images. Reported metadata fields include, but are not limited to, title, filename, file size, SHA-1 digest, container format, duration, pixel dimension, display aspect ratio (DAR), scan type (progressive, interlaced, or telecined), frame rate, and per-stream metadata (type, codec, profile, dimensions, bitrate, etc.). Scroll down for a few sample storyboards.
Note that this README only provides an overview and summary of the topics listed below. For more details, follow the main article link in each section.
Structure of this document
- Installation and dependencies
- Command-line usage
- Sample storyboards
Main article: https://storyboard.readthedocs.io/en/latest/index.html
storyboard was inspired by the storyboards I frequently encounter on video-sharing Internet forums, mostly generated by proprietary video players. Those storyboards often come with video/file metadata bundled, which I see as a great all-in-one solution for video sharing, saving one the labor of typing multiple console commands, copying and pasting output, and worrying about the forum's crappy formatting. However, I, for one, dislike proprietary players. Also, those storyboards are usually ugly and uninformative, using stupid fonts and lacking crucial information that hackers look for (e.g., hash). Therefore, I developed this customizable storyboard generator for hackers.
Installation and dependencies
Main article: https://storyboard.readthedocs.io/en/latest/install.html
Pillow. This dependency will be picked up by
pipwhen you install
storyboard, but you also have to satisfy the external dependencies, especially
libfreetype. See the official installation guide for details. (Satisfying external dependencies is very important on Linux, where no wheel distribution is provided on PyPI.)
End users should use
pip install storyboard
Developers should clone the git repo for docs, tests, and more.
Main article: https://storyboard.readthedocs.io/en/latest/cli.html
This package installs two console scripts,
storyboard. You may find documentation of both using the
-h,--help option. Extensive documentation is also available for both:
By the way, the default invocation is really simple (for both): just supply one or more video paths.
Main article: https://storyboard.readthedocs.io/en/latest/sample.html
Main article: https://storyboard.readthedocs.io/en/latest/issue.html
Please use the GitHub issue tracker: https://github.com/zmwangx/storyboard/issues.
CJK support in filename and title? In short, no.
Found a codec you need that has no binding in
metadata.pyand leads to stupid output? File an issue or open a pull request. Please link a sample file if it is not commonly seen and cannot be encoded by FFmpeg.
ffprobemight report the wrong duration for certain VOB or other videos, which screws up the whole thing. As a fallback, you can use the option
storyboard. Note however that this option is extremely slow, and improving it is on my list.
This package comes with
SourceCodePro-Regular.otf as the default font, which is subject to the license of the Source Code Pro font family. See
LICENSE.txt for details.
Source code in this package is released under the MIT license.