Updating codebase.rst to reflect the modern mediagoblin world

[mediagoblin.git] / docs / source / media-types.rst

.. MediaGoblin Documentation

   Written in 2011, 2012 by MediaGoblin contributors

   To the extent possible under law, the author(s) have dedicated all
   copyright and related and neighboring rights to this software to
   the public domain worldwide. This software is distributed without
   any warranty.

   You should have received a copy of the CC0 Public Domain
   Dedication along with this software. If not, see
   <http://creativecommons.org/publicdomain/zero/1.0/>.

.. _media-types-chapter:

====================
Enabling Media Types
====================

In the future, there will be all sorts of media types you can enable,
but in the meanwhile there's only one additional media type: video.

First, you should probably read ":doc:`configuration`" to make sure
you know how to modify the mediagoblin config file.

Video
=====

To enable video, first install gstreamer and the python-gstreamer
bindings (as well as whatever gstremaer extensions you want,
good/bad/ugly).  On Debianoid systems::

    sudo apt-get install python-gst0.10

Next, modify (and possibly copy over from ``mediagoblin.ini``) your
``mediagoblin_local.ini``.  Uncomment this line in the ``[mediagoblin]``
section::

    media_types = mediagoblin.media_types.image, mediagoblin.media_types.video

Now you should be able to submit videos, and mediagoblin should
transcode them.

Note that you almost certainly want to separate Celery from the normal
paste process or your users will probably find that their connections
time out as the video transcodes.  To set that up, check out the
":doc:`production-deployments`" section of this manual.