whitewater 1.0.1

Convert videos into a format readable by the Whitewater Player Javascript library.

A command line utility that converts short videos a format that can be played on mobile websites with the Whitewater Player Javascript library.

→ Full Documentation

→ Whitewater Player (needed to play videos)

→ Example Site

Installation

$ pip install whitewater

Usage

$ whitewater <file> [options]
$ whitewater (-h | --help | --version)

Example:

$ whitewater path/to/video.mp4

Options

--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.

Python Module

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()