• How to create and use .stream files in Wowza Streaming Engine Manager

    This tutorial shows how to use Wowza Streaming Engine™ live streaming software to create and use .stream files to re-stream live streaming output from sources such as MPEG-TS encoders and IP cameras.


    Configure Wowza Streaming Engine Manager to re-stream a live stream
    More resources


    Stream files provide a method to replace (alias) complex stream names that are published to Wowza Streaming Engine from sources such as MPEG-TS encoders and IP cameras. For example, if your complex stream name on the origin server is udp://, you can create a stream file named mycoolevent.stream and assign the contents to the complex stream name. Players can then use mycoolevent.stream in playback URLs in place of the more complex stream name. Stream files are stored in an application's streaming file directory and have a .stream file name extension.

    Configure Wowza Streaming Engine Manager to re-stream a live stream

    To use Wowza Streaming Engine Manager, do the following:

    1. Sign in to Wowza Streaming Engine Manager as an Administrator. You must have administrator privileges to create stream files. For more information, see Manage credentials.

    2. In the Server contents panel, click Stream Files, and then click Add Stream File.

      Note: You can also access the Stream Files feature from the Applications tab under the currently selected application.
    3. In the Add Stream File dialog box, enter a name for the stream file and the URI of the source stream, and then click Add.

    4. (Optional) Specify per-stream settings. Per-stream settings override those in the application configuration for that stream and apply only to the types of streams identified by the configuration. For more information, see How to specify per-stream settings in .stream files.

    5. To start the stream, click the Connect icon to connect to the stream.

    6. In the Connect a Stream File dialog box, in Application Name, select that name of a live application that will host the stream. Then in Mediacaster Type, select a MediaCaster type that corresponds to the stream type.

      The MediaCaster types in the list correspond to the following stream types:

      • rtp. IP Camera streams (RTSP/RTP streams) and streams from native RTP and MPEG-TS encoders.

      • shoutcast. SHOUTCast/Icecast streams.

      • liverepeater. Streams pulled from another server running Wowza media server software.

      • applehls (supported in Wowza Streaming Engine and later). Apple HLS streams pulled from a live source.

    7. Click OK.

    Wowza Streaming Engine can now use the MediaCaster system to re-stream the live streams. The MediaCaster system can pull the streams that are referenced in a stream file and make them available for streaming to all player technologies supported by the server. The MediaCaster system works on-demand. When the first request is received from a player for the stream file, the source stream referenced in the file is made available to the player. When the last player stops viewing the stream, the MediaCaster system waits for a timeout period. If no other players request the file, the stream is stopped and isn't available for streaming until another request is made.

    More resources

    How to specify per-stream settings in .stream files
    How to re-stream video from an IP camera (RTSP/RTP re-streaming)
    How to re-stream audio from SHOUTcast/Icecast
    How to publish and play a live stream (MPEG-TS based encoder)
    How to publish and play a live stream (Apple HLS)

    Originally Published: 08-11-2014.
    Updated: For Wowza Streaming Engine on 08-18-2016.

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