Difference between revisions of "Source DSP Plug-in Configuration Examples"

From Winamp Developer Wiki
Jump to: navigation, search
m (Fixed incorrect note about sc_trans streamid usage)
m
 
(6 intermediate revisions by one user not shown)
Line 1: Line 1:
 +
{{Template:NavBarSC}}
 +
 +
 
=Introduction=
 
=Introduction=
  
The aim of this document is to show you what needs to be entered in the different options in the plug-ins configuration window to allow it to work with the sc_serv2 and sc_trans configuration examples. The setups covered are:
+
The aim of this document is to show you what needs to be entered in the different options in the plug-ins configuration window to allow it to work with the DNAS server (sc_serv2) and Transcoder (sc_trans) configuration examples. The setups covered are:
  
#Connecting as a source directly to the server
+
#Connecting as a source to the server in SHOUTcast 2 and SHOUTcast 1 (legacy) modes
#Connecting as a DJ to a transcoder in SHOUTcast 2
+
#Connecting as a DJ to a transcoder in SHOUTcast 2 and SHOUTcast 1 (legacy) modes
#Connecting as a DJ to a transcoder in SHOUTcast 1 (legacy mode)
+
  
  
 
=Configurations=
 
=Configurations=
  
In all of the example configurations, it is assumed that Winamp has been chosen as the input source for the stream(s) being created and that all of the passwords used are the same as those in the sc_serv2 and sc_trans example configuration files. Remember that you should change the example passwords when setting up your SHOUTcast system.
+
In all of the example configurations, it is assumed that Winamp has been chosen as the input source for the stream(s) being created and that all of the passwords used are the same as those in the DNAS server and Transcoder example configuration files. Remember that you should change the example passwords when setting up your SHOUTcast system.
  
The choice of the encoder used is left as something for you to decide upon considering the DSP plug-in supports MP3, AAC+ and AAC LC along with all of the different bitrates, etc. However this should not cause an issue with the example setups used but is something you need to decide upon as part of the general process in setting up a SHOUTcast system.
+
The choice of the encoder used is left as something for you to decide upon considering the DSP plug-in supports MP3 and AAC along with all of the different bitrates, etc. However this should not cause an issue with the example setups used but is something you need to decide upon as part of the general process in setting up a SHOUTcast system.
  
Finally the name of the options as shown in the english translation of the plug-in on its 'Output' tab ([[Source_DSP_Plug-in#Output_Tab|see dsp_sc.txt - section 3.2]]) will be used in this file to identify the options which need to be entered. This is mentioned incase a localised version of the DSP plug-in is used (a nice feature implemented in version 2 of the plug-in).
+
Finally the name of the options as shown in the english translation of the plug-in on its 'Output' tab ([[Source_DSP_Plug-in#Output_Tab|see Source DSP - section 3.2]]) will be used in this file to identify the options which need to be entered. This is mentioned incase a localised version of the DSP plug-in is used (a nice feature implemented in version 2 of the plug-in).
  
  
==Direct Source to a Server (sc_serv2)==
+
==Direct Source to a SHOUTcast v2 DNAS Server==
  
 
Connection Tab
 
Connection Tab
 
----
 
----
 +
[[Image:Direct_Source_to_a_SHOUTcast_v2_DNAS_Server.png|200px|thumb|right|Direct Source to a SHOUTcast v2 DNAS Server]]
 +
'''Server Address''' : localhost (or the IP of the server if it is different from the local machine ([[Source_DSP_Plug-in#Connection Tab|see Source DSP - section 3.2.1]] for more information)).
  
'''Address''' : localhost (or the IP of the server if it is different from the local machine ([[Source_DSP_Plug-in#Connection Tab|see dsp_sc.txt - section 3.2.1]] for more information)).
+
'''Port''' : 8000 (or the value set for 'portbase' ([[SHOUTcast_DNAS_Server_2#Networking|see DNAS Server - section 4.8]])).
  
'''Port''' : 8000 (or the value set for 'portbase' ([[SHOUTcast_DNAS_Server_2#Networking|see sc_serv2.txt - section 4.0.8]])).
+
'''Stream ID''' : 1 (or the value set for 'streamid' for the relevant connection being made to the server ([[SHOUTcast_DNAS_Server_2#Stream_Configuration|see DNAS Server - section 4.12]])).
  
'''Stream ID''' : 1 (or the value set for 'streamid' for the relevant connection being made to the server ([[SHOUTcast_DNAS_Server_2#Stream_Configuration|see sc_serv2.txt - section 4.0.12]])).
+
'''DJ / User ID''' : this can be left blank and is not used with a source connection.
  
'''User ID''' : this can be left blank and is not used with a source connection.
+
'''Password''' : testing (or the value set for 'password' ([[SHOUTcast_DNAS_Server_2#Networking|see DNAS Server - section 4.8]])).
  
'''Password''' : testing (or the value set for 'password' ([[SHOUTcast_DNAS_Server_2#Networking|see sc_serv2.txt - section 4.0.8]])).
+
'''Use SHOUTcast v1 mode (for legacy servers)''' : ensure this is '''UNCHECKED'''.
 
+
'''Use SHOUTcast v1 mode (for legacy servers)''' : ensure this is UNCHECKED.
+
  
  
Yellowpages Tab
+
Directory Tab
 
----
 
----
  
Here you can enter any details as required to identify or provide contact details for your stream to any clients connecting or when viewed on the YP directory listing.
+
Here you can enter any details as required to identify or provide contact details for your stream to any clients connecting or when viewed on the SHOUTcast Directory listing.
  
'''Make this server public (Recommended)''' : The usage of this setting depends upon the value of 'publicserver' in your server configuration. See [[SHOUTcast_DNAS_Server_2#YP_Server_Behaviour|sc_serv2.txt - section 4.0.14]] for details.
+
'''Make this server public (Recommended)''' : The usage of this setting depends upon the value 'publicserver' in your server configuration. See [[SHOUTcast_DNAS_Server_2#YP_Server_Behaviour|DNAS Server - section 4.14]] for details.
  
  
==DJ Source to the Transcoder (sc_trans) in SHOUTcast 2 Mode==
+
==Direct Source to a SHOUTcast v1 DNAS Server (Legacy)==
  
 
Connection Tab
 
Connection Tab
 
----
 
----
 +
[[Image:Direct_Source_to_a_SHOUTcast_v1_DNAS_Server_(Legacy).png|200px|thumb|right|Direct Source to a SHOUTcast v1 DNAS Server (Legacy)]]
 +
'''Server Address''' : localhost (or the IP of the server if it is different from the local machine ([[Source_DSP_Plug-in#Connection Tab|see Source DSP - section 3.2.1]] for more information)).
  
'''Address''' : localhost (or the IP of the server if it is different from the local machine ([[Source_DSP_Plug-in#Connection Tab|see dsp_sc.txt - section 3.2.1]] for more information)).
+
'''Port''' : 8000 (or the value set for 'portbase' for the SHOUTcast v1 DNAS server used).
  
'''Port''' : 8505 (or the value set for 'djport2' ([[SHOUTcast_DNAS_Transcoder_2#DJ_Support|see sc_trans.txt - section 3.0.3]])).
+
'''DJ / User ID''' : this ''must'' be left blank and is not used with a source connection.
  
'''Stream ID''' : this can be left as the default value ('1') as the Transcoder effectively ignores this for this connection though may be used in future versions.
+
'''Password''' : testing (or the value set for 'password' for the SHOUTcast v1 server used).
  
'''User ID''' : dj (or the value set for 'djlogin' for the respective DJ account setup in the sc_trans configuration ([[SHOUTcast_DNAS_Transcoder_2#DJ_Support|see sc_trans.txt - section 3.0.3]])).
+
'''Use SHOUTcast v1 mode (for legacy servers)''' : ensure this is '''CHECKED'''.
  
'''Password''' : noise (or the value set for 'djpassword' for the respective DJ account setup in the sc_trans configuration ([[SHOUTcast_DNAS_Transcoder_2#DJ_Support|see sc_trans.txt - section 3.0.3]])).
 
  
'''Use SHOUTcast v1 mode (for legacy servers)''' : ensure this is UNCHECKED.
+
Directory Tab
 +
----
  
Yellowpages Tab
+
Here you can enter any details as required to identify or provide contact details for your stream to any clients connecting or when viewed on the SHOUTcast Directory listing.
 +
 
 +
 
 +
==DJ Source to the Transcoder in SHOUTcast v2 Mode==
 +
 
 +
Connection Tab
 
----
 
----
 +
[[Image:DJ_Source_to_the_Transcoder_in_SHOUTcast_v2_Mode.png|200px|thumb|right|DJ Source to the Transcoder in SHOUTcast v2 Mode]]
 +
'''Server Address''' : localhost (or the IP of the server if it is different from the local machine ([[Source_DSP_Plug-in#Connection Tab|see Source DSP - section 3.2.1]] for more information)).
  
Here you can enter any details as required to identify or provide contact details for your stream to any clients connecting or when viewed on the YP directory listing.
+
'''Port''' : 8505 (or the value set for 'djport2' ([[SHOUTcast_DNAS_Transcoder_2#DJ_Support|see Transcoder - section 3.3]])).
  
Make this server public (Recommended) : The usage of this setting depends upon the value of 'publicserver' in your server configuration. See [[SHOUTcast_DNAS_Server_2#YP_Server_Behaviour|sc_serv2.txt - section 4.0.14]] for details.
+
'''Stream ID''' : this can be left as the default value ('1') as the Transcoder effectively ignores this for this connection though may be used in future versions.
  
 +
'''DJ / User ID''' : dj (or the value set for 'djlogin' for the respective DJ account setup in the sc_trans configuration ([[SHOUTcast_DNAS_Transcoder_2#DJ_Support|see Transcoder - section 3.3]])).
  
==DJ Source to the Transcoder (sc_trans) in SHOUTcast 1 Mode (Legacy)==
+
'''Password''' : noise (or the value set for 'djpassword' for the respective DJ account setup in the sc_trans configuration ([[SHOUTcast_DNAS_Transcoder_2#DJ_Support|see Transcoder - section 3.3]])).
  
Connection Tab
+
'''Use SHOUTcast v1 mode (for legacy servers)''' : ensure this is UNCHECKED.
 +
 
 +
 
 +
Directory Tab
 
----
 
----
  
'''Address''' : localhost (or the IP of the server if it is different from the local machine ([[Source_DSP_Plug-in#Connection Tab|see dsp_sc.txt - section 3.2.1]] for more information)).
+
Here you can enter any details as required to identify or provide contact details for your stream to any clients connecting or when viewed on the SHOUTcast Directory listing.
  
'''Port''' : 8500 (or the value set for 'djport' ([[SHOUTcast_DNAS_Transcoder_2#DJ_Support|see sc_trans.txt - section 3.0.3]])).
+
Make this server public (Recommended) : The usage of this setting depends upon the value 'publicserver' in your server configuration. See [[SHOUTcast_DNAS_Server_2#YP_Server_Behaviour|DNAS Server - section 4.14]] for details.
  
'''Password''' : dj:noise (or the values set for 'djlogin' and 'djpassword' for the respective DJ account setup in sc_trans's configuration [[SHOUTcast_DNAS_Transcoder_2#DJ_Support|see sc_trans.txt - section 3.0.3]])).
 
  
'''Use SHOUTcast v1 mode (for legacy servers)''' : ensure this is CHECKED.
+
==DJ Source to the Transcoder in SHOUTcast v1 Mode (Legacy)==
  
Yellowpages Tab
+
Connection Tab
 
----
 
----
 +
[[Image:DJ_Source_to_the_Transcoder_in_SHOUTcast_v1_Mode_(Legacy).png|200px|thumb|right|DJ Source to the Transcoder in SHOUTcast v1 Mode (Legacy)]]
 +
'''Server Address''' : localhost (or the IP of the server if it is different from the local machine ([[Source_DSP_Plug-in#Connection Tab|see Source DSP - section 3.2.1]] for more information)).
  
Here you can enter any details as required to identify or provide contact details for
+
'''Port''' : 8500 (or the value set for 'djport' ([[SHOUTcast_DNAS_Transcoder_2#DJ_Support|see Transcoder - section 3.3]])).
your stream to any clients connecting or when viewed on the YP directory listing.
+
  
'''Make this server public (Recommended)''' : The usage of this setting depends upon the value of 'publicserver' in your server configuration. See [[SHOUTcast_DNAS_Server_2#YP_Server_Behaviour|sc_serv2.txt - section 4.0.14]] for details.
+
'''DJ / User ID''' : dj (or the value set for 'djlogin' for the respective DJ account setup in the sc_trans configuration ([[SHOUTcast_DNAS_Transcoder_2#DJ_Support|see Transcoder - section 3.3]])).
  
 +
'''Password''' : noise (or the value set for 'djpassword' for the respective DJ account setup in the sc_trans configuration [[SHOUTcast_DNAS_Transcoder_2#DJ_Support|see Transcoder - section 3.3]])).
  
=SHOUTcast 2 Cipher Key=
+
'''Use SHOUTcast v1 mode (for legacy servers)''' : ensure this is CHECKED.
  
If you find that you do need to change the uvoxcipherkey ([[SHOUTcast_DNAS_Server_2#YP_Server_Behaviour|sc_serv2.txt - section 4.0.14]]) or the djcipher ([[SHOUTcast_DNAS_Transcoder_2#DJ_Support|sc_trans.txt - section 3.0.3]]) in you sc_serv and / or sc_trans setups then you can change the cipher key the DSP uses. You will only need to do this if you get the following status message when making a connection:
 
  
    Authentication Error:
+
Directory Tab
    Cipher Does Not Match
+
----
  
This is done currently via editing 'Cipherkey' entry in dsp_sc.ini in your Winamp config folder where you just need to change the string after the equal sign to the value from 'uvoxcipherkey' or 'djcipher' depending upon what you are trying to connect to.
+
Here you can enter any details as required to identify or provide contact details for your stream to any clients connecting or when viewed on the SHOUTcast Directory listing.
  
The dsp_sc.ini file can usually be found by entering %appdata%\Winamp\plugins into the address bar in Windows Explorer. If it is not there then you should search for dsp_sc.ini and make sure to have the search program you are using to look for hidden files (this is just incase the OS is hiding the settings folder).
+
'''Make this server public (Recommended)''' : The usage of this setting depends upon the value 'publicserver' in your server configuration. See [[SHOUTcast_DNAS_Server_2#YP_Server_Behaviour|DNAS Server - section 4.14]] for details.

Latest revision as of 23:01, 28 October 2014

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


Introduction

The aim of this document is to show you what needs to be entered in the different options in the plug-ins configuration window to allow it to work with the DNAS server (sc_serv2) and Transcoder (sc_trans) configuration examples. The setups covered are:

  1. Connecting as a source to the server in SHOUTcast 2 and SHOUTcast 1 (legacy) modes
  2. Connecting as a DJ to a transcoder in SHOUTcast 2 and SHOUTcast 1 (legacy) modes


Configurations

In all of the example configurations, it is assumed that Winamp has been chosen as the input source for the stream(s) being created and that all of the passwords used are the same as those in the DNAS server and Transcoder example configuration files. Remember that you should change the example passwords when setting up your SHOUTcast system.

The choice of the encoder used is left as something for you to decide upon considering the DSP plug-in supports MP3 and AAC along with all of the different bitrates, etc. However this should not cause an issue with the example setups used but is something you need to decide upon as part of the general process in setting up a SHOUTcast system.

Finally the name of the options as shown in the english translation of the plug-in on its 'Output' tab (see Source DSP - section 3.2) will be used in this file to identify the options which need to be entered. This is mentioned incase a localised version of the DSP plug-in is used (a nice feature implemented in version 2 of the plug-in).


Direct Source to a SHOUTcast v2 DNAS Server

Connection Tab


File:Direct Source to a SHOUTcast v2 DNAS Server.png
Direct Source to a SHOUTcast v2 DNAS Server

Server Address : localhost (or the IP of the server if it is different from the local machine (see Source DSP - section 3.2.1 for more information)).

Port : 8000 (or the value set for 'portbase' (see DNAS Server - section 4.8)).

Stream ID : 1 (or the value set for 'streamid' for the relevant connection being made to the server (see DNAS Server - section 4.12)).

DJ / User ID : this can be left blank and is not used with a source connection.

Password : testing (or the value set for 'password' (see DNAS Server - section 4.8)).

Use SHOUTcast v1 mode (for legacy servers) : ensure this is UNCHECKED.


Directory Tab


Here you can enter any details as required to identify or provide contact details for your stream to any clients connecting or when viewed on the SHOUTcast Directory listing.

Make this server public (Recommended) : The usage of this setting depends upon the value 'publicserver' in your server configuration. See DNAS Server - section 4.14 for details.


Direct Source to a SHOUTcast v1 DNAS Server (Legacy)

Connection Tab


File:Direct Source to a SHOUTcast v1 DNAS Server (Legacy).png
Direct Source to a SHOUTcast v1 DNAS Server (Legacy)

Server Address : localhost (or the IP of the server if it is different from the local machine (see Source DSP - section 3.2.1 for more information)).

Port : 8000 (or the value set for 'portbase' for the SHOUTcast v1 DNAS server used).

DJ / User ID : this must be left blank and is not used with a source connection.

Password : testing (or the value set for 'password' for the SHOUTcast v1 server used).

Use SHOUTcast v1 mode (for legacy servers) : ensure this is CHECKED.


Directory Tab


Here you can enter any details as required to identify or provide contact details for your stream to any clients connecting or when viewed on the SHOUTcast Directory listing.


DJ Source to the Transcoder in SHOUTcast v2 Mode

Connection Tab


File:DJ Source to the Transcoder in SHOUTcast v2 Mode.png
DJ Source to the Transcoder in SHOUTcast v2 Mode

Server Address : localhost (or the IP of the server if it is different from the local machine (see Source DSP - section 3.2.1 for more information)).

Port : 8505 (or the value set for 'djport2' (see Transcoder - section 3.3)).

Stream ID : this can be left as the default value ('1') as the Transcoder effectively ignores this for this connection though may be used in future versions.

DJ / User ID : dj (or the value set for 'djlogin' for the respective DJ account setup in the sc_trans configuration (see Transcoder - section 3.3)).

Password : noise (or the value set for 'djpassword' for the respective DJ account setup in the sc_trans configuration (see Transcoder - section 3.3)).

Use SHOUTcast v1 mode (for legacy servers) : ensure this is UNCHECKED.


Directory Tab


Here you can enter any details as required to identify or provide contact details for your stream to any clients connecting or when viewed on the SHOUTcast Directory listing.

Make this server public (Recommended) : The usage of this setting depends upon the value 'publicserver' in your server configuration. See DNAS Server - section 4.14 for details.


DJ Source to the Transcoder in SHOUTcast v1 Mode (Legacy)

Connection Tab


File:DJ Source to the Transcoder in SHOUTcast v1 Mode (Legacy).png
DJ Source to the Transcoder in SHOUTcast v1 Mode (Legacy)

Server Address : localhost (or the IP of the server if it is different from the local machine (see Source DSP - section 3.2.1 for more information)).

Port : 8500 (or the value set for 'djport' (see Transcoder - section 3.3)).

DJ / User ID : dj (or the value set for 'djlogin' for the respective DJ account setup in the sc_trans configuration (see Transcoder - section 3.3)).

Password : noise (or the value set for 'djpassword' for the respective DJ account setup in the sc_trans configuration see Transcoder - section 3.3)).

Use SHOUTcast v1 mode (for legacy servers) : ensure this is CHECKED.


Directory Tab


Here you can enter any details as required to identify or provide contact details for your stream to any clients connecting or when viewed on the SHOUTcast Directory listing.

Make this server public (Recommended) : The usage of this setting depends upon the value 'publicserver' in your server configuration. See DNAS Server - section 4.14 for details.