• How to duplicate streams to another application instance (DuplicateStreams)

    The ModuleDuplicateStreams module for Wowza Streaming Engine™ media server software enables you to duplicate a stream from one application instance to another instance on the same Wowza media server.

    Contents


    Prerequisites
    Installation
    Configuration
    Properties
    Usage
    For developers

    Prerequisites


    Wowza Streaming Engine 4.0.0 or later is required.

    Installation


    1. Download wse-plugin-duplicatestreams.zip.

    2. Extract the contents from the downloaded (zipped) package, and then copy the lib/wse-plugin-duplicatestreams.jar file from the package to the lib folder in your Wowza Streaming Engine installation ([install-dir]/lib).

    3. Restart Wowza Streaming Engine.

    Configuration


    To enable this module, add the following module definition to your application configuration. See Configure modules for details.

    Name
    Description
    Fully Qualified Class Name
    ModuleDuplicateStreams Duplicates streams to another application instance. com.wowza.wms.plugin.ModuleDuplicateStreams

    Properties


    After enabling the module, you can adjust the default settings by adding the following properties to your application. See Configure properties for details.

    Path
    Name
    Type
    Value
    Notes
    /Root/Application duplicateStreamsStreamNames String * A comma-separated list of stream names. Use the wildcard (*) character by itself to indicate all streams will be duplicated or to substitute for characters at the beginning or end of stream names. For example: *_720p,*_360p,*_240p,*_160p. (default: *)
    /Root/Application duplicateStreamsTargetVHostName String _defaultVHost_ Name of target virtual host (VHost). (default: _defaultVHost_)
    /Root/Application duplicateStreamsTargetAppName String live/_definst_ Name of the target application/application instance. (default: live/_definst_)
    /Root/Application duplicateStreamsStreamNameSuffix String _dest Suffix to add to the stream name on the target application instance. Set to an empty string to have the same name published on the target. (default: _dest)

    Usage


    When a stream is published to the configured application, the stream name is checked against the values in the duplicateStreamsStreamNames property, and if a match is found, the stream is re-published to the application specified in duplicateStreamsTargetAppName. When the source stream is unpublished, the duplicate stream is also shut down.

    For developers


    Source code is available on GitHub.

    Wowza Media Systems™ provides developers with a platform to create streaming applications and solutions. See Wowza Developer Tools to learn more about our APIs and SDK.
    Wowza media server software and all components, including modules, source code, and other related items offered on this page, are copyrighted (c) 2006-2016 by Wowza Media Systems, LLC, all rights reserved, and are licensed pursuant to the Wowza Media Software End User License Agreement.
    Originally Published: For Wowza Streaming Engine on 06-19-2014.
    Updated: 05-18-2016.

    If you're having problems or want to discuss this article, post in our forum.