SHOUTcast Server Source Support - Revision history

DrO: Typo fix

2015-05-27T22:21:20Z

Typo fix

DrO at 01:53, 16 March 2015

2015-03-16T01:53:07Z

DrO: Tweak url formatting

2015-03-15T18:07:18Z

Tweak url formatting

DrO at 20:01, 13 March 2015

2015-03-13T20:01:45Z

DrO: Add info about port forwarding requirements

2015-03-13T19:58:42Z

Add info about port forwarding requirements

DrO: Move image

2015-02-12T13:24:46Z

Move image

DrO: Add DJ support and some wording tweaks

2015-02-11T21:45:13Z

Add DJ support and some wording tweaks

DrO: Protected "SHOUTcast Server Source Support" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)) [cascading]

2015-02-11T17:26:25Z

Protected "SHOUTcast Server Source Support" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)) [cascading]

DrO: 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..."

2015-02-11T17:26:02Z

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..."

New page

{{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. 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==

[[Image:View_Source_Login_Details.png|225px|thumb|right|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.

@@ Line 60: / Line 60: @@
 ==Is There Anything Else?==
-To ensure that SHOUTcast 1 protocol compatible source clients areable to access the DNAS server, you may need to open an additional port to just '''[[SHOUTcast_DNAS_Server_2#Networking|portbase]]''' to allow the source connection to be made if it is not from the same machine or the same local network as the DNAS server i.e. you are making an external source connection.
+To ensure that SHOUTcast 1 protocol compatible source clients are able to access the DNAS server, you may need to open an additional port to just '''[[SHOUTcast_DNAS_Server_2#Networking|portbase]]''' to allow the source connection to be made if it is not from the same machine or the same local network as the DNAS server i.e. you are making an external source connection.
   If the source is running on the same machine or local network then you
   will not need to open any additional ports for the connection to work.

← Older revision		Revision as of 01:53, 16 March 2015
Line 9:		Line 9:


−	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.	+	With the release of the v2.4.7 DNAS server (and future versions), 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.


Line 19:		Line 19:


−	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).	+	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.4.7 DNAS server (and future versions) 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).

@@ Line 65: / Line 65: @@
-How to do this will depend upon your setup but often requires ports to be opened on the router and in the Operating System's firewall. You should be able to find information for your router on how to do port forwarding from http://www.portforward.com/ (which only requires TCP connections to be forwarded and not UDP connections).
+How to do this will depend upon your setup but often requires ports to be opened on the router and in the Operating System's firewall. You should be able to find information for your router on how to do port forwarding from [http://www.portforward.com | www.portforward.com] (which only requires TCP connections to be forwarded and not UDP connections).
-Usually you will be forwarding port 8000 as well as port 8001 (which is the actual port that the SHOUTcast 1 protocol uses for source connections). If you have changed '''[[SHOUTcast_DNAS_Server_2#Networking|portbase]]''' from it's default value then you will need to ensure that '''portbase+1''' is opened so that the external source connection can be made. You can use http://www.yougetsignal.com/tools/open-ports/ to confirm that the port forwarding is working correctly (just ensure the DNAS server is actually running at the time!).
+Usually you will be forwarding port 8000 as well as port 8001 (which is the actual port that the SHOUTcast 1 protocol uses for source connections). If you have changed '''[[SHOUTcast_DNAS_Server_2#Networking|portbase]]''' from it's default value then you will need to ensure that '''portbase+1''' is opened so that the external source connection can be made. You can use [http://www.yougetsignal.com/tools/open-ports | www.yougetsignal.com/tools/open-ports] to confirm that the port forwarding is working correctly (just ensure the DNAS server is actually running at the time!).
   If not done correctly then the source connection will fail

@@ Line 61: / Line 61: @@
 To ensure that SHOUTcast 1 protocol compatible source clients areable to access the DNAS server, you may need to open an additional port to just '''[[SHOUTcast_DNAS_Server_2#Networking|portbase]]''' to allow the source connection to be made if it is not from the same machine or the same local network as the DNAS server i.e. you are making an external source connection.
@@ Line 66: / Line 68: @@
-Usually you will be forwarding port 8000 as well as port 8001 (which is the actual port that the SHOUTcast 1 protocol uses for source connections). If you have changed '''[[SHOUTcast_DNAS_Server_2#Networking|portbase]]''' from it's default value then you will need to ensure that '''portbase+1''' is correctly opened. You can use http://www.yougetsignal.com/tools/open-ports/ to confirm that the port forwarding is working correctly (just ensure the DNAS server is actually running at the time!).
+Usually you will be forwarding port 8000 as well as port 8001 (which is the actual port that the SHOUTcast 1 protocol uses for source connections). If you have changed '''[[SHOUTcast_DNAS_Server_2#Networking|portbase]]''' from it's default value then you will need to ensure that '''portbase+1''' is opened so that the external source connection can be made. You can use http://www.yougetsignal.com/tools/open-ports/ to confirm that the port forwarding is working correctly (just ensure the DNAS server is actually running at the time!).
   If not done correctly then the source connection will fail

← Older revision		Revision as of 19:58, 13 March 2015
Line 56:		Line 56:

	This support is currently used just to see which DJ / User is connected as the source client for the stream, however in future DNAS releases then this may be used as a way to do additional controlling of the source client connections to the DNAS server.		This support is currently used just to see which DJ / User is connected as the source client for the stream, however in future DNAS releases then this may be used as a way to do additional controlling of the source client connections to the DNAS server.
		+
		+
		+	==Is There Anything Else?==
		+
		+	To ensure that SHOUTcast 1 protocol compatible source clients areable to access the DNAS server, you may need to open an additional port to just '''[[SHOUTcast_DNAS_Server_2#Networking\|portbase]]''' to allow the source connection to be made if it is not from the same machine or the same local network as the DNAS server i.e. you are making an external source connection.
		+
		+
		+	How to do this will depend upon your setup but often requires ports to be opened on the router and in the Operating System's firewall. You should be able to find information for your router on how to do port forwarding from http://www.portforward.com/ (which only requires TCP connections to be forwarded and not UDP connections).
		+
		+
		+	Usually you will be forwarding port 8000 as well as port 8001 (which is the actual port that the SHOUTcast 1 protocol uses for source connections). If you have changed '''[[SHOUTcast_DNAS_Server_2#Networking\|portbase]]''' from it's default value then you will need to ensure that '''portbase+1''' is correctly opened. You can use http://www.yougetsignal.com/tools/open-ports/ to confirm that the port forwarding is working correctly (just ensure the DNAS server is actually running at the time!).
		+
		+	If not done correctly then the source connection will fail
		+	either due to a connection timeout or an unknown error code.

@@ Line 24: / Line 24: @@
 ==How To Do It==
 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).
@@ Line 60: / Line 59: @@
 ==Additional Information==
 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.

← Older revision		Revision as of 21:45, 11 February 2015
Line 33:		Line 33:
	the value to enter in the source client password field is: '''bob:#2'''		the value to enter in the source client password field is: '''bob:#2'''

		+	stream #1 is the default stream assumed for a SHOUTcast 1 protocol compatible source client
		+	and so it is not necessary to add ''':#1''' to the end of the password, though it is ok to do this

−	'''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.

		+	The colon character is now a reserved character and cannot be used as a value in passwords. If the DNAS server detects a colon then the password will be rejected and the DNAS server may abort running.

		+
		+	===DJ / User ID===
		+	----
		+	In addition to the ability to provide the stream identifier, it is also possible to provide a DJ / User ID for the source connection. This is done in a similar manner but places the DJ / User ID value at the start of the password field
		+
		+	e.g.
		+
		+	'''<dj>:<password>'''
		+
		+	or
		+
		+	'''<dj>:<password>:#<sid>'''
		+	'''<dj>''' is the value to send
		+	'''<password>''' is the configured stream password
		+	'''<sid>''' is the required stream identifier
		+
		+
		+	This support is currently used just to see which DJ / User is connected as the source client for the stream, however in future DNAS releases then this may be used as a way to do additional controlling of the source client connections to the DNAS server.
		+
		+
		+	==Additional Information==
	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.		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.

← Older revision	Revision as of 17:26, 11 February 2015
(No difference)