Adding a streaming music source

Last Updated : Apr 11, 2022 |

About this task

Perform the following procedure to add a streaming music source that uses RSS, HLS, or ICY protocols over HTTP.

Before you begin

The music source you configure must meet the following requirement for each provider:

RSS requirements:

  • The audio must be encoded in MPEG-1 Audio Layer 3 (MP3), MPEG-2 Audio Layer 3 (MP3) or WAV.

  • The maximum RSS document size is 256 KB.

HTTP/MP3 SHOUTCast and ICY requirements:

  • Mono and stereo are supported.

  • The audio must be encoded in MPEG-1 Audio Layer 3 (MP3) or MPEG-2 Audio Layer 3 (MP3).

  • Supported MPEG-1 sample rates: 32000, 44100, and 48000 Hz.

  • Supported MPEG-2 sample rates: 22050, 24000, and 16000 Hz.

  • Supported bit rates: 32, 64, 96, 128, 160, 192, 256 and 320 kbps.

  • The AAC codec is not supported.

  • Content type for playlists must be audio/x-scpls or audio/x-mpegurl.

  • Content type for audio must specify audio/mpeg, audio/x-mpeg or application/octet-stream.

  • The server can respond with ICY 200 OK or standard HTTP 200 OK responses.

  • The ICY MetaData update mechanism is supported. Use of this update mechanism is optional.

  • VLC and Icecast streaming sources are supported as long as the codec and content type used are also supported.

  • HTTP Proxy is supported. Use of an HTTP proxy is required when the HTTP/MP3 server returns documents containing URLs on non-standard HTTP ports that are not permitted through the firewall.

HLS requirements:

  • The audio must be encoded in MPEG-1 Audio Layer 3 (MP3), MPEG-2 Audio Layer 3 (MP3) or AAC-LC.

  • Mono and stereo are supported. Stereo sources are mixed into mono.

  • AAC sampling rates are supported in the 8 kHz to 96 kHz range.

  • Supported MPEG-1 sample rates: 32000, 44100, and 48000 Hz.

  • Supported MPEG-2 sample rates: 22050, 24000, and 16000 Hz.

  • Supported bit rates: 32, 64, 96, 128, 160, 192, 256 and 320 kbps.

  • M3U8 master playlist and nested media playlist files are supported. Playlist and media URLs can be made relative to the master playlist document.

  • HTTP Proxy is supported. Use of an HTTP proxy is required when the HLS server returns documents containing URLs on non-standard HTTP ports that are not permitted through the firewall

  • Content types should be application/vnd.apple.mpegurl or audio/mpegurl and document extensions must be .m3u8 or .m3u

  • HLS M3U8/M3U meta-data is supported: 
    #extinf:<duration>, <author - title>

  • The use of encryption is not supported.

  • Servers which require authentication are not supported.

  • Video is not supported.

Procedure

  1. Navigate to EM > System Configuration > Media Processing > Music > Stream Provisioning.
  2. Click Add...
  3. In the Stream Type field, click the music source type.
  4. In the Name field, enter a name for the new music source.

    The system uses this name as the stream key.

  5. To form a stream key in the form name@domain in the Domain field, enter a domain name.
  6. In the Primary URL field, enter the address of the required music source.
  7. To provide an alternate music source, in the Backup URL field, enter the address of another music source.

    The system automatically switches to the backup music source when the primary source is unavailable.

  8. To add the music source in the locked state so that system does not use the new music source, select the Locked check box.
  9. Click Save.

    The system displays the Stream Provisioning page. The color of the Stream Key indicates the connection status of the music source.

    Note:

    The Stream Provisioning page does not automatically update the status. Manually refresh the web page to update the status or see Monitoring music streams.

Next Steps

Monitoring music streams.