[[PlayerToc(plugins)]]

= Revolt plugin = 

This plugin renders some cool visualizations in the display, great to juice up playback of MP3 files. It contains 6 presets. All visualization code is developed by [http://www.anttikupila.com Antti Kupila]; this plugin is simply a wrapper around his great stuff.

This plugin is compatible with version 4.1 of the player.

== Example == 

Here is an example of the revolt plugin in action. Below is the string of flashvars used:

[[JWPlayer(400,250,file=/player/testing/files/bunny.mp3&repeat=always&plugins=revolt&revolt.gain=2)]]

{{{
file=/player/testing/files/bunny.mp3&repeat=always&plugins=revolt&revolt.gain=2
}}}

== Configuration == 

The plugin is loaded with the flashvar ''plugins=revolt''. This will automatically load the latest version of the plugin straight off our servers. It offers two additional flashvars for tweaking the plugin:

 * '''revolt.gain''' (''1''): set this to a value larger than 1 to retain interesting graphics if your original file has a low volume.  
 * '''revolt.timeout''' (''10''): the number of seconds a visualization will be shown. After each timeout, the plugin will randomly jump to another preset.

Note that audio waveform data is subject to the [wiki:FlashSecurity Crossdomain security restrictions] of Flash. This means that a player on one domain cannot display visualizations from an MP3 from another domain. It can be fixed by placing a [wiki:FlashSecurity  crossdomain.xml] file at the server the MP3 are loaded from. To further complicate matters though, the waveform generation uses a runtime-wide function, which actually gathers waveform data from all sound currently being played back in Flash on your computer. This means that the revolt plugin will actually fail to generate visuals if, for example, you have another browserwindow open that is playing a Youtube video...

== Source code == 

The source code of this plugin can be obtained [changeset:HEAD/plugins/revolt?old_path=%2F&format=zip in a zip] (click the zip links at the bottom) or through [http://subversion.tigris.org/ Subversion]:

{{{
svn co http://developer.longtailvideo.com/svn/plugins/revolt
}}}

If you don't have a Subversion client, check out [http://tortoisesvn.tigris.org/ Tortoise] (Windows) or [http://scplugin.tigris.org/ SC Plugin] (MAC).

You don't need Adobe Flash to modify this plugin. Instead, you can edit the plugin with any text editor you like. The plugin can be compiled with the free, cross-platform [http://www.adobe.com/cfusion/entitlement/index.cfm?e=flex3sdk MXMLC compiler]. See our [wiki:PluginsCompiling plugin compiling overview] for more info.