Create and use .stream files in Wowza Streaming Engine

Create and use .stream files in Wowza Streaming Engine™ media server software to re-stream live streaming output with the MediaCaster feature from sources such as MPEG-TS encoders and IP cameras (RTSP/RTP streams), SHOUTcast/Icecast streams, native RTP encoders, and Secure Reliable Transport (SRT) streams.

About stream files


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 (RTSP/RTP streams), SHOUTcast/Icecast streams, native RTP encoders, and Secure Reliable Transport (SRT) streams. For example, if your complex stream name on the origin server is udp://0.0.0.0:10000, 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.

Before you start


You should complete the following tasks:

Configure Wowza Streaming Engine to re-stream a live stream


  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. Note that it is important to use the IP address of the server hosting the stream as the Stream URI.
     
    The Stream URI is formatted http://[stream IP]:1400/stream for pull streams.

     
  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 Specify per-stream settings in Wowza Streaming Engine .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, for Application Name, select the live application that will host the stream.

  1. For Mediacaster Type, select a MediaCaster type that corresponds to the stream type.



    MediaCaster types 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 using the RTMP protocol or via the WOWZ protocol from another Wowza Streaming Engine instance.
       
    • applehls (supported in Wowza Streaming Engine 4.5.0.01 and later). Apple HLS streams pulled from a live source.
       
    • mpegtstcp (supported in Wowza Streaming Engine 4.5.0.02 and later). MPEG-TS streams pulled from a live source over a TCP/IP connection.
    • srt (supported in Wowza Streaming Engine 4.7.2 and later for Linux and Wowza Streaming Engine 4.7.3 and later for Windows). Secure Reliable Transport (SRT)connections.
  2. Click OK.
Wowza Streaming Engine can now use the MediaCaster system to re-stream the live streams. MediaCaster can pull the streams that are referenced in a stream file and make them available for streaming to all player technologies supported by Wowza Streaming Engine. MediaCaster 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, MediaCaster waits for a timeout period. If no other players request the file, the stream stops until another request is made.

More resources