Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

pypm install unimr.red5.protectedvod

How to install unimr.red5.protectedvod

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install unimr.red5.protectedvod
 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
0.1rc1-r96721 Available View build log
Windows (64-bit)
0.1rc1-r96721 Available View build log
Mac OS X (10.5+)
0.1rc1-r96721 Available View build log
Linux (32-bit)
0.1rc1-r96721 Available View build log
Linux (64-bit)
0.1rc1-r96721 Available View build log
Lastest release
version 0.1rc1-r96721 on Jan 5th, 2011


unimr.red5.protectedvod implements a video-on-demand (vod) or audio-on-demand solution for secure flash streaming with Red5 server. It provides a way to protect your media files from being directly downloaded from Plone or from being "leeched" by other sites. For this purpose the streaming URL is secured by altering the requested URL with a signature. When the video/audio file is requested, the path of the file is individually signed by Plone for each request and the streaming is delegated to Red5. Red5 checks afterwards the signature of the incoming request for validity by a shared secret (only known by Plone and Red5!). If the signature is valid Red5 delivers the stream. The signature is unique, context specific and its duration of validity is limited. Plone's security context is therefore completely preserved in Red5. Nobody can copy-and-paste that URL anywhere he want and load the video.



Add unimr.red5.protectedvod to your buildout as normal. See http://plone.org/documentation/tutorial/buildout. Don't forget to load the configure.zcml file!

Then install the product via Plone's Add-on products control panel.


Both Plone and Red5 require a shared file system with read/write access. Follow the installation instructions of iw.fss and remember that only site storage strategies site1 and site2 are supported by unimr.red5.protectedVOD. Red5 needs the file extension of the media content to work.


In portal_properties/red5_protectedvod_properties you have to configure the Red5 server URL, TTL (time to live) in sec of your signature and the shared secret for generating the signature.


Example Archetype

The included Archetype Red5Stream integrates the GPL version of flowplayer with Plone 3.x. It can play video files (FLV, H.246, MP4) as well as audio files (MP3). Clients with "view" permission can only view the content by the streaming technique of Red5 but cannot directly download the content. Per default only clients with owner or manager role have the "Download Red5Stream" permission to download the content from Plone.

Kupu integration

To make it easier to present Red5Streams within a content item of Plone, this product installs a new Kupu paragraph style. You can use them like this:

1. Insert the image you want to use as a splash image. You should insert this "inline" (rather than left/right floating), preferably in its own paragraph. Alternatively, you can also enter a text as placeholder.

2. Select on the image (or placeholder text), and make it link to the .flv or .mp3 file you want to play.

  1. Select the red5-stream style from the styles drop-down.

Signature & streaming URL

The dynamically signed streaming URL takes the following format:


The parts of this URL are as follows:

  • baseURL is determined based on the relative path of the

System Message: WARNING/2 (<string>, line 100)

Bullet list ends without a blank line; unexpected unindent.

video/audio content in the FileSystemStorage.

  • signature is calculated as follows:

System Message: WARNING/2 (<string>, line 103)

Bullet list ends without a blank line; unexpected unindent.

hmac.new(shared_secret + baseUrl + streamName + client ip + expires).hexdigest() where shared_secret is specified in Plone's configuration and should match the value on the red5 server.

  • expires is a timestamp given as a hex string. This is the number

System Message: WARNING/2 (<string>, line 108)

Bullet list ends without a blank line; unexpected unindent.

of seconds since January 1, 1970, 00:00:00 in hexadecimal notation plus the the ttl configured in Plone portal_properties.

  • streamName is the name of the video file, for example,

System Message: WARNING/2 (<string>, line 112)

Bullet list ends without a blank line; unexpected unindent.

Extremists.flv, flowplayer.flv, or rocknroll.mp4.

Red5 application

This package includes the corresponding Red5 application protectedVOD as WAR-archive (also a tgz-Archive of the java sources; s. README.txt in red5-wabapp directory of this product for further information). Don't forget to change/synchronize the shared secret in both Plone's and Red5's configuration!


  • Support for symbolic links for the used file system
  • FileSystemStorage (iw.fss)
  • Red5 server (v0.8.x)


  • Andreas Gabriel <gabriel _at_ hrz.uni-marburg.de>
  • David Nax <naxd _at_ hrz.uni-marburg.de>


  • clustering implementation
  • collective.flowplayer integration


0.1 (xxxx-xx-xx)
  • Initial release

Subscribe to package updates

Last updated Jan 5th, 2011

Download Stats

Last month:2

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.