Difference between revisions of "SHOUTcast Server Source Support"

From Winamp Developer Wiki
Jump to: navigation, search
(Created page with "{{Template:NavBarSC}} ==Introduction== The SHOUTcast DNAS server since the introduction of v2.0 has been able to provide multiple streams from a single DNAS server instance...")
(No difference)

Revision as of 18:26, 11 February 2015

Shoutcast Home | Shoutcast Server (DNAS) | Shoutcast Developer (API) | Shoutcast For Business & Revenue Generation | Shoutcast DSP (encoder Plug-In for Winamp)


Introduction

The SHOUTcast DNAS server since the introduction of v2.0 has been able to provide multiple streams from a single DNAS server instance. To be able to do this, it has required the source for the stream to be a relay (pulling a copy of the stream from another server) or by using SHOUTcast 2 protocol compatible source client software (where you specify the stream number to connect to as part of the source configuration).

The downside of this is that unless you are relaying or using an updated source client, existing source client software which is only SHOUTcast 1 protocol compatible has only been able to connect as the source from stream #1 (due to not being able to indicate the required stream number). There was a partial workaround by using the 'streamportlegacy' option but this had issues and was marked as an experimental feature.


With the release of the v2.5 DNAS server, not being able to use multiple SHOUTcast 1 protocol compatible source software to connect as the source for any stream on the DNAS server has now been removed. The changes to support this will typically not require any source client software updates as this is all handled by the DNAS server as long as the correct password is provided.


How It Works

With the SHOUTcast 2 protocol, the ability to specify the desired stream for the source client to be used for is a core part of the protocol via the required stream identifier. Whereas the SHOUTcast 1 protocol was designed before it was considered to be able to provide multiple streams from a single DNAS server instance (as the v2.x DNAS server supports) and so there is no direct means in the protocol to specify the stream identifier.

All SHOUTcast source client connections require a password to be provided irrespective of the SHOUTcast protocol version being used and with the SHOUTcast 1 protocol, this is the first primary piece of information sent to the DNAS server when the source is attempting to connect.


By manipulating the password provided from a SHOUTcast 1 protocol compatible source client to also include the intended stream identifier, it is now possible for the DNAS server to know the intended stream the source client is to be used for. This is what will now allow for the v2.5 DNAS server to be able to support multiple SHOUTcast 1 protocol compatible source clients along with the added benefit of not requiring source client software updates (though native SHOUTcast 2 protocol support is preferred over SHOUTcast 1 protocol based source clients).


How To Do It

View_Source_Login_Details.png

To connect a SHOUTcast 1 protocol compatible source client to a specific stream then you can append :#<sid> to the end of the password to be used so you have <password>:#<sid> (where <password> is the configured stream password and <sid> is the required stream identifier).

e.g.

to connect to stream #2 with the configured password as bob

the value to enter in the source client password field is: bob:#2


Note: stream #1 is the default stream assumed for a SHOUTcast 1 protocol compatible source client, it is not necessary to add :#1 to the end of the password. There is nothing to stop this from being done especially if it makes source client implementations easier.


If you are still unsure about what to enter into the source client password field, the View Source Login Details page (found on the DNAS server admin summary page) which shows the appropriate password to use for the different SHOUTcast protocol source clients via the Password and Legacy Password values shown.