A command line utility that converts short videos into the Whitewater format.
Together, Whitewater Encoder and Whitewater Player give you the ability to play inline video in mobile web browsers complete with programatic playback controls and events.
$ pip install whitewater
Download the package and run the setup script:
$ cd path/to/module $ python setup.py install
The Whitewater package contains a simple command line interface.
$ whitewater <file> [options] $ whitewater (-h | --help | --version)
$ whitewater path/to/video.mp4
The script can take a handful of options:
-d, --debug Turn on debug mode. --blocksize <size> The width/height of a single grid cell when checking one frame against the previous one. --grid <size> The size of the diffmap images in rows and columns, not absolute pixels. --quality <percent> JPEG quality setting. --threshold <rms> RMS threshold for determining whether a single cell of a frame is different from the previous one. --format <filetype> File format to save diffmap images as.
For a full explanation of what these do and when you might want to use them, check the documentation.
Whitewater can also be used as a module in your own Python scripts. The Whitewater() class and its options are described in detail in the full documentation.
from whitewater import Whitewater video = Whitewater('path/to/video.mp4') video.encode()