Django Videologue

Videologue is a reusable Django application that provides powerful video management functionality as well as a complete video gallery solution.

What does it do?

Videologue's VideoModel abstract class adds a original_video and flv_video field to your model, and adds any uploaded videos to a model for batch processing. After processing the flv_video field and image field of the model are updated with the processed video data. This class is a subclass of Photologue's ImageModel abstract class so the model has the same properties for displaying the image grabbed from the video.

Plug Videologue into your existing apps using foreign key relationships and enjoy a better experience managing uploaded videos.

Adds a management command to called vlprocess that handles the batch converting of videos.

Videologue comes with a complete set of example templates for setting up a video gallery fast. Define a master template, apply some styles and you've got a complete video gallery system for your site or blog.


  1. Make sure you got ffmpeg and ffmpeg is compiled with the lame mp3 encoder.

  2. Unless you are running ffmpeg from svn you need flvtool and ruby, eek!

    If running ffmpeg from svn add VIDEOLOGUE_FLVTOOL = None to your since ffmpeg now adds metadata for you.

  3. Get the required third party modules

    ``git clone git://``
    or download `here`__.
    ``svn checkout``
  4. Add the videologue directory to your Python path.

  5. Add the needed apps to INSTALLED_APPS

  6. Add this to crontab to make videos convert automatically on upload.

    Example: crontab -e

    # add env and run every two minutes
    */2     *     *     *     *         python /path/to/project/projectname/ vlprocess
  7. Get Flowplayer and serve the swf.

    Set the setting FLOWPLAYER to the location of the flowplayer swf.

  8. If you want the video gallery add videologue.urls to your projects urlconf:

    (r'^videos/', include('videologue.urls')),

    Copy the templates to adapt them for your site

  9. If the the default settings are not suited to your needs you have theese settings available:

    VIDEOLOGUE_FFMPEG defaults to ffmpeg

    VIDEOLOGUE_FLVTOOL defaults to flvtool2

    VIDEOLOGUE_VIDEO_SIZE defaults to 320x240

    VIDEOLOGUE_IMAGE_SIZE defaults to 320x240

    VIDEOLOGUE_AUDIO_CODEC defaults to libmp3lame

    VIDEOLOGUE_AUDIO_BITRATE defaults to 32000