Configure Wowza Streaming Engine™ media server software to recieve an encoded live stream from an RTSP/RTP-based source and play the live stream over all supported streaming protocols.
Configure the live streaming application
Live streams are configured and managed in live applications in Wowza Streaming Engine. You can configure a live application in Wowza Streaming Engine Manager or by setting properties in the application's XML configuration file. Both methods produce the same result; editing Application.xml is the only option if you use Wowza Media Server™ software.
Configure the live application in Wowza Streaming Engine Manager
This example uses the default live application that installs with Wowza Streaming Engine.
You can use Wowza Streaming Engine Manager with the latest version of most web browsers that support HTML5 and Cascading Style Sheets level 3 (CSS 3). We recommend Google Chrome.
- In Wowza Streaming Engine Manager, click the Applications tab at the top of the page and then select the live application in the contents panel.
Start by enabling playback over all supported protocols: Adobe HDS, Adobe RTMP, Apple HLS, Microsoft Smooth Streaming, MPEG-DASH, and RTSP/RTP.
- On the Setup tab of the live application page, make sure all Playback Types are selected. If necessary, click Edit, select them all, and then click Save.
Note: Every time you edit an application's configuration, Wowza Streaming Engine prompts you to restart the application. However, you can wait until all changes are completed before you restart.
Next, disable playback authentication.
- In the contents panel, click Playback Security, and then click Edit.
- Under Client restrictions, select No client restrictions, and then click Save.
Next, enable source authentication for the encoder.
- In the contents panel, click Source Security, and then click Edit.
- On the Source Security page, under RTSP Sources, select Require password authentication.
- Under Client Restrictions, select No client restrictions.
- Click Save and then restart the application.
The application runs whenever Wowza Streaming Engine is running.
You're almost done. To finish, configure the source user name and password to publish to the application.
- Click Server in the menu bar, click Source Authentication in the contents panel, and then click Add Source.
- Enter a Source User Name and Password, and then click Add.
Configure the live application in XML
This section shows you how to configure the live application by editing the Application.xml configuration file in a text editor. If you configured the live application in Wowza Streaming Engine Manager, skip this section.
- Navigate to [install-dir]/conf/live and open Application.xml in a text editor.
- In the <Streams> container element, make sure the <StreamType> property is live. The XML looks like this:
<Streams> ... <StreamType>live</StreamType> ... </Streams>
- Set the <HTTPStreamers> property for all supported HTTP streaming protocols. The XML looks like this:
- Set the <LiveStreamPacketizers> property for HDS, HLS, Microsoft Smooth Streaming, and MPEG-DASH streaming. The XML looks like this:
<Streams> ... <LiveStreamPacketizers>cupertinostreamingpacketizer,smoothstreamingpacketizer,sanjosestreamingpacketizer,mpegdashstreamingpacketizer</LiveStreamPacketizers> ... </Streams>
- In the <RTP> container element, make sure playback authentication is disabled by setting the <PlayMethod> property to none. The XML looks like this:
<RTP> <Authentication> ... <PlayMethod>none</PlayMethod> </Authentication> ... </RTP>
- Save your changes and close Application.xml.
- Navigate to [install-dir]/conf/ and open publish.password in a text editor.
- Add a source user name and password to control RTSP/RTP source access. Following is an example of the file with the source name publisherName and a password:
# Publish password file (format [username][space][password]) # username password publisherName [password]
- Save your changes and close publish.password.
- Restart Wowza Streaming Engine or Wowza Media Server.
Publish the source stream to Wowza Streaming Engine
In your encoder, enter the following application connection settings, and then click Publish or Start:
- Server URL – rtsp://[wowza-ip-address]:1935/live
- Stream Name – myStream
- User – publisherName
- password – [password]
Note: See the documentation for your source encoder for help configuring it. If your encoder requires authentication, add the credentials before the IP address. Credentials can contain alphanumeric, period (.), underscore (_), and hyphen (-) characters. Other characters must be URL-encoded (percent-encoded).
To verify that the stream is published, click Incoming Streams for the live application in Wowza Streaming Engine Manager, and then click the stream name. Uptime, network throughput, and other information about the published stream appear on the page.
In Wowza Streaming Engine Manager, click Test Players in the upper-right corner of the live application page.
Each tab in the Test Players window either hosts a test player that can play the live stream, or provides instructions for playing the live stream. The test players are preconfigured to stream the default live stream myStream.
For example, to test playback of the default stream myStream over Adobe HDS, make sure the encoder is sending a stream to the live application in Wowza Streaming Engine and that Adobe Flash is enabled in the browser you're using. Then, click the Adobe HDS tab and click Start.
You can also test your live stream by using the test players online on our Wowza Test Players webpage, or by using the example players that install with Wowza Streaming Engine at [install-dir]/examples/. For more information, see any of these articles:
- Play streams with the Adobe RTMP example player in Wowza Streaming Engine
- Play streams with Adobe HDS example player in Wowza Streaming Engine
- Play streams with the Silverlight example player in Wowza Streaming Engine
- Play streams with the MPEG-DASH example player in Wowza Streaming Engine
- Play Wowza Streaming Engine streams on Apple iOS devices
- Play Wowza Streaming Engine streams on RTSP/RTP players