Relaying Another Stream

By relaying another stream, you are using a remote streaming server as the source for your broadcast, and rebroadcasting that server's stream as your own.

The procedure for relaying another stream varies depending on the streaming server software you are using.

SHOUTcast v1

SHOUTcast v1 can only broadcast a single audio stream, so configuring a relay on SHOUTcast v1 is only used when you do not want to broadcast any original content of your own, and simply want to provide a mirror of the remote server.

Note that the remote server must also be an SHOUTcast v1 server.

To configure relaying:

1. In the navigation panel at the left-hand side of the screen, click Settings under the Configuration heading.

2. Click the Relaying tab. If you do not see a Relaying tab, then you are not using SHOUTcast v1 and are looking at the wrong section.

3. In the Stream server field, enter the hostname or IP address of the remote SHOUTcast server, eg: foo.example.com.

4. In the Stream port field, enter the port number for the remote SHOUTcast server, eg: 8000.

5. Click Update to save your changes.

6. The server should now be ready for master relaying. Stop, then restart the server to apply your configuration changes.

7. When your server comes back online, tune in to your relay server as a listener and verify that you hear the audio stream from the master server.

If you encounter any problems in step 7, there is most likely an error in your relay configuration. To troubleshoot the problem, visit the Logs page and look for errors in your Error Log.

SHOUTcast v2

Under SHOUTcast v2, a relay is simply configured as an additional mount point which rebroadcasts a single mount point from a remote SHOUTcast v1 or SHOUTcast v2 server. This allows you to provide a mirror of a single mount point from the remote server while still using your own SHOUTcast server to broadcast other content.

To configure relaying:

1. In the navigation panel at the left-hand side of the screen, click Settings under the Configuration heading.

2. Click the Mount Points tab. If you do not see a Mount Points field, then you are not using SHOUTcast v2 and are looking at the wrong section.

3. Under the Current mount points selection box, click the Create new button to create a new mount point.

4. Select the newly-created mount point and click the Settings tab.

5. In the Stream path field, set an appropriate path for the new relay mount point, eg: /myrelay. If you do not see a Stream path field, then you are not using SHOUTcast v2 and are looking at the wrong section.

6. Click the AutoDJ tab.

7. Ensure that Use autoDJ is set to No.

8. Click the Relaying tab.

9. In the Relay URL field, enter the complete URL to the remote stream to relay, eg: http://foo.example.com:8000/ (if the remote server is a SHOUTcast v1 server) or http;//foo.example.com:8000/stream (if the remote server is a SHOUTcast v2 server which uses mount points).

   1. Click Update to save your changes.

   2. The server should now be ready for relaying. Stop, then restart the server to apply your configuration changes.

   3. When your server comes back online, tune in to your server as a listener using the relay mount point and verify that you hear the audio stream from the master server.

If you encounter any problems in step 12, there is most likely an error in your relay configuration. To troubleshoot the problem, visit the Logs page and look for errors in your Error Log.

IceCast

Two types of relays are available under IceCast: master relaying and mount point relaying.

Master Relaying

Master relaying causes all mount points from a remote IceCast server to be rebroadcasted on your server. This is used when you do not want to broadcast any original content of your own, and simply want to provide a complete mirror of the remote server.

Note that the remote server must also be an IceCast server and must be configured to allow master relaying. A master relay password will typically be required.

To configure master relaying:

1. In the navigation panel at the left-hand side of the screen, click Settings under the Configuration heading.

2. Click the Master Relaying tab. If you do not see a Master Relaying tab, then you are not using IceCast and are looking at the wrong section.

3. In the Master server field, enter the hostname or IP address of the remote IceCast server, eg: foo.example.com.

4. In the Master port field, enter the port number for the remote IceCast server, eg: 8000.

5. In the Master update interval field, enter the master update interval for this relay. The master update interval determines how often, in seconds, the relay will poll the master server to see if any new mount points are available to relay. Typically 60 to 120 seconds is a reasonable value.

6. In the Master password field, enter the master relay password for the remote server.

7. In the Relay on demand field, choose whether or not to enable relay-on-demand. If enabled, the relay will only connect to the master IceCast server when one or more listeners are connected, and it will disconnect from the remote server when there are no more listeners. This saves bandwidth, but will also cause a short delay when the the first listener connects to the stream.

8. Click the AutoDJ tab, if it exists, and ensure that AutoDJ Status is set to Disabled. This is critical as a server configured for master relaying cannot broadcast any other content, so the autoDJ will not be able to function in this mode.

9. Click Update to save your changes.

   1. The server should now be ready for master relaying. Stop, then restart the server to apply your configuration changes.

   2. When your server comes back online, tune in to your relay server as a listener and verify that you hear the audio stream from the master server.

If you encounter any problems in step 11, there is most likely an error in your relay configuration. To troubleshoot the problem, visit the Logs page and look for errors in your Error Log.

Mount Point Relaying

Mount point relaying allows your server to rebroadcast a single mount point from a remote SHOUTcast or IceCast server. This allows you to provide a mirror of a single mount point from the remote server while still using your own IceCast server to broadcast other content.

To configure mount point relaying:

1. In the navigation panel at the left-hand side of the screen, click Settings under the Configuration heading.

2. Click the Mountpoint Relaying tab. If you do not see a Mountpoint Relaying tab, then you are not using IceCast and are looking at the wrong section.

3. In the Stream server field, enter the hostname or IP address of the remote streaming server, eg: foo.example.com.

4. In the Stream port field, enter the port number for the remote streaming server, eg: 8000.

5. In the Stream mount point field, enter the mount point to relay from the remote server, eg: /stream. If the remote server is a SHOUTcast v1 server (which does not support mount points), enter "/".

6. In the Local mount point field, enter the local mount point on which you want to rebroadcast the audio stream on your server, eg: /myrelay.

7. In the Stream username field, enter the username required by the remote server to access the mount point (if any).

8. In the Stream password field, enter the password required by the remote server to access the mount point (if any).

9. In the Relay on demand field, choose whether or not to enable relay-on-demand. If enabled, the relay will only connect to the master server when one or more listeners are connected, and it will disconnect from the remote server when there are no more listeners. This saves bandwidth, but will also cause a short delay when the the first listener connects to the stream.

   1. In the Relay metadata field, choose whether or not to pull metadata updates from the remote server and display them to your listeners.

   2. Click Update to save your changes.

   3. The server should now be ready for mount point relaying. Stop, then restart the server to apply your configuration changes.

   4. When your server comes back online, tune in to your server as a listener using the relay mount point and verify that you hear the audio stream from the master server.

If you encounter any problems in step 13, there is most likely an error in your relay configuration. To troubleshoot the problem, visit the Logs page and look for errors in your Error Log.

Source: Centova Cast Client Usage Guide