This tutorial provides the basic steps for re-streaming a SHOUTcast or Icecast stream through Wowza Media Server® and to configure an application named live
to stream to the Adobe® Flash® Player, Apple® iOS devices, and RTSP/RTP-based players.
Note: Microsoft® Silverlight® doesn’t support audio-only Smooth Streaming.
This tutorial provides basic steps for setting up an application for live streaming and configuring Application.xml.
- Create application folder [install-dir]/applications/live.
- Create configuration folder [install-dir]/conf/live and copy [install-dir]/conf/Application.xml to this new folder.
- Edit the newly copied Application.xml file and make the following changes (some of these settings may already be present):
- Set the Streams/StreamType property to:
- Set the HTTPStreamers property to:
- Set the Streams/LiveStreamPacketizers property to:
- Set the RTP/Authentication/PlayMethod to:
Publishing the stream
- Use a text editor to create the file [install-dir]/content/radiostation.stream and set the contents of this file to the full HTTP URL of a SHOUTcast or Icecast stream (see URL to connect to SHOUTcast or Icecast).
- Using a text editor, edit the [install-dir]/conf/admin.password file and add a username and password that will be used to start and stop publishing of the radio station (below is an example of the file with the username myuser and password mypassword):
# Admin password file (format [username][space][password])
# username password
- Start Wowza Media Server.
- Use Stream Manager to start the stream:
- Enter the following URL in a web browser :
- in the Security dialog box, enter your admin username and password from above.
- In the Stream Manager webpage, click the [start-receiving-stream] link just below the live application folder.
- In the Start Receiving Stream dialog box, select the following MediaCaster Type option: shoutcast
- In the Stream Name field, enter radiostation.stream.
- Click OK.
Note: In the following examples, [wowza-ip-address] is the IP address or domain name of the server running Wowza Media Server.
Adobe Flash Player (RTMP)
In Wowza Media Server 3.5.0 and later, double-click [install-dir]/examples/SHOUTcast/FlashRTMPPlayer/player.html, enter the information below, and then click theConnect button.
To play the stream from a remote computer, copy the FlashRTMPPlayer folder to a web server, and then connect to: http://<webserver>/FlashRTMPPlayer/player.html.
In Wowza Media Server 3.1.2 and earlier, double-click [install-dir]/examples/SHOUTcast/client/shoutcast.html
, enter the information below, and then click the Play
To play the stream from a remote computer, copy the client folder to a web server, and then connect to: http://<webserver>/client/shoutcast.html.
Adobe Flash Player (San Jose/Adobe HDS)
In Wowza Media Server 3.5.0 and later, double-click [install-dir]/examples/LiveVideoStreaming/FlashHTTPPlayer/player.html, enter the information below, and then click the Connect button.
To play the stream from a remote computer, copy the FlashHTTPPlayer folder to a web server, and then connect to: http://<webserver>/FlashHTTPPlayer/player.html.
In Wowza Media Server 3.1.2 and earlier, double-click [install-dir]/examples/LiveVideoStreaming/clientOSMF/bin-release/LiveOSMFPlayer.html
, enter the information below, and then click the Play
To play the stream from a remote computer, copy the clientOSMF/bin-release folder to a web server, and then connect to: http://<webserver>/bin-release/LiveOSMFPlayer.html.
The stream can only be played from an OSMF-based
Flash player that’s embedded in a webpage.
Apple iOS device (Cupertino/Apple HLS)
Enter the following URL into the Safari® web browser on the device:
Note: This stream can also be played using the Safari web browser or QuickTime 10.x on a computer running Mac OS® X Snow Leopard version 10.6 and later.
Enter the following URL into the RTSP/RTP player:
Flash RTMP clients only
(Optional) If your application will only stream to Flash RTMP clients, in [install-dir]/conf/live/Application.xml, you can set the Streams/StreamType property to:
If you do this, then you won’t need to use StreamManager (see Publishing the stream). The first Flash client that plays the stream will trigger Wowza Media Server to start re-streaming.
Also, in [install-dir]/conf/live/Application.xml, make sure that the Streams/LiveStreamPacketizers property is empty:
URL to connect to SHOUTcast or Icecast
The URL that you use to connect to a SHOUTcast or Icecast server is one of the URLS that is contained in a SHOUTcast playlist (.pls) file or Icecast playlist (.m3u) file. Most websites that publish SHOUTcast or Icecast streams have links on their sites that reference these files. To re-stream a SHOUTcast or Icecast stream, you must first download one of the playlist files to your local computer and use one of the links found inside to connect to the published stream.
- RTSP/RTP streaming is used to stream to Android™ and BlackBerry® mobile devices. Newer Android-based phones also support Adobe Flash Player 10.1 and later, along with RTMP and Adobe HTTP Dynamic Streaming (Adobe HDS).
- To stream to RTSP/RTP, be sure that UDP ports 0-65535 are open and properly mapped to the server running Wowza Media Server.
- It’s very important to carefully follow the instructions provided in How to troubleshoot RTSP/RTP playback to properly configure Wowza Media Server for RTSP/RTP streaming.
Common problems with .stream files
Many text editors will append a .txt filename extension to the radiostation.stream filename. This will result in an error message similar to the following:
SDP file missing: c:/program files/wowzamediasystems/wowzamediaserver[version]/content/radiostation.stream
To fix this, go to the [install-dir]/content folder and remove the .txt filename extension from the file.
Property to change AAC packetization method
Wowza Media Server can output AAC audio using the mpeg4-generic and mp4a-latm (3gpp) packetization methods. The default packetization method is mpeg4-generic. To switch to mp4a-latm (3gpp), add the following property to the RTP/Properties container in [install-dir]/[application]/Application.xml (be sure to get the correct<Properties> container, there are several in the Application.xml file):