VirtualStreams Plugin for Wowza
The intent of this plugin is to provide "virtual" streams, that replace encoders or enable work-arounds when accessing a VOD file is not an option. Possible use cases include testing live streams, or rewriting requests to virtual live streams (with GeoIP plugin for example).
The plugin should be compatible against Wowza 4.5.0+.
Installing the plugin
Copy the provided
jar files into your WowzaStreamingEngine's
lib/ folder. On Linux
systems, the location for it is usually
The VirtualStreams plugin is installed into the main
The following snippet should be added just before
<ServerListener> <BaseClass>com.titpetric.wse.server.VirtualStreams</BaseClass> </ServerListener>
The WowzaStreamingEngine needs to be restarted to enable the plugin.
The plugin will look for configuration in this location:
The virtual streams are created on server startup and are not reloaded or added while the server is running.
The configuration file has the following structure:
<?xml version="1.0" encoding="utf-8"?> <virtualstreams> <stream vhost="red300" app="live1" file="mp4:sorry.mp4" name="sorry_vod.sdp"/> </virtualstreams>
<virtualstreams> object includes one or more
<stream> definitions. The
is declared with several mandatory parameters:
|vhost||The virtual host name where a virtual stream should be created|
|app||The application on which a virtual stream should be created|
|file||The file which the virtual stream will play in a loop|
|name||The name of the virtual stream provided to users|
In the example above, a virtual stream is created with:
- the name
sorry_vod.sdp(users will request the stream by this name),
- the file
mp4:sorry.mp4(the virtual stream will loop this video),
appwhere the stream will be
red300 is created on port
3000, the request for the virtual stream might be
made with the following url:
The VirtualStreams plugin is developed by Tit Petrič (c), all rights reserved.