Metadata-Version: 2.0
Name: whitewater
Version: 1.0.1
Summary: Convert videos into a format readable by the Whitewater Player Javascript library.
Home-page: https://github.com/samiare/whitewater-encoder
Author: Samir Zahran
Author-email: sayhello@samiare.net
License: MIT
Keywords: video mobile
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Utilities
Requires-Dist: docopt (>=0.6.2)
Requires-Dist: imageio (>=1.4)
Requires-Dist: numpy (>=1.10.2)
Requires-Dist: Pillow (>=3.0.0)

Whitewater Encoder
==================

A command line utility that converts short videos into the Whitewater
format.

Description
-----------

Together, Whitewater Encoder and `Whitewater
Player <https://github.com/samiare/whitewater-player>`__ give you the
ability to play inline video in mobile web browsers complete with
programatic playback controls and events.

Installation
============

>From `PyPI <http://pypi.python.org>`__
--------------------------------------

.. code:: bash

    $ pip install whitewater

Manual installation
-------------------

`Download the
package <https://github.com/samiare/whitewater-encoder/releases/latest>`__
and run the setup script:

.. code:: bash

    $ cd path/to/module
    $ python setup.py install

Usage
=====

Command Line
------------

The Whitewater package contains a simple command line interface.

.. code:: bash

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

**Basic Example**

.. code:: bash

    $ whitewater path/to/video.mp4

Options
~~~~~~~

The script can take a handful of 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 <https://github.com/samiare/whitewater-encoder/wiki/Appendix>`__.

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 <https://github.com/samiare/whitewater-encoder/wiki>`__.

.. code:: python

    from whitewater import Whitewater

    video = Whitewater('path/to/video.mp4')
    video.encode()

Full Documentation
------------------

`Check out the
wiki <https://github.com/samiare/whitewater-encoder/wiki>`__.

✌︎


