Difference between revisions of "SHOUTcast Broadcaster"

From Winamp Developer Wiki
Jump to: navigation, search
(pull out section titles)
m (Add reference to Nak errors page)
(18 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
{{Template:NavBar}}
 
{{Template:NavBar}}
== OVERVIEW ==
 
  
# O1. Where do I get the IP address I need to use?
+
Here you can find copies of the SHOUTcast tools documentation and other information relating to using the SHOUTcast v2 system from the tools to details about the the SHOUTcast Radio Directory API. Most of the documentation is also provided in the installers / distribution files of the different SHOUTcast v2 system tools though the versions provided here should typically contain the most up-to-date version of the documentation relating to the currently provided version of the tools.
# Answer: Nullsoft/AOL don't presently provide free bandwidth or servers to broadcast from. You need to talk to your ISP or someone with a big fat internet connection and convince them to run the server for you so you can broadcast from it.
+
# O2. Who is my system administrator?
+
# Answer: The system administrator is the person responsible for computers on your network. If you aren't on a network, then you are your own system administrator. SHOUTcast Radio broadcasting can be a fairly complex process, so bring someone along who's familiar with things like IP networking if you feel less than comfortable with computers.
+
  
== DNAS ==
 
  
# D1. How do I use the on-demand content features of the DNAS?
+
=SHOUTcast Overview=
# Answer: The DNAS installs with a folder called content/. Place any MP3 files inside this directory, and they're ready to be streamed on-demand. The server will even automatically generate a playlist for any individual item of content so you can have browsers automatically pass the content off to a player without having to make playlists yourself.
+
# Example: Your server has a file called song.mp3 in the content/ folder. Your SHOUTcast Radio DNAS is running on port 8000 at my.host.com.
+
# You can listen to my song <A HREF= "http://my.host.com:8000/content/song.pls">here</A>
+
# NOTE: The file song.pls DOES NOT EXIST in your content directory! If a file with the same name exists with the .mp3 extension, the DNAS will automatically generate the .pls file.
+
# NOTE: Subdirectories DO NOT work for the content section, to help prevent malicious users from tramping around your filesystem.
+
# D2. Why does the SHOUTcast Radio directory think I'm at a different IP than I really am?
+
# Answer: The SHOUTcast Radio directory used to run on the honor system. That was, it took you at your word on what IP you were broadcasting at. Since about twenty billion people abused that to send people to not-so-friendly sites, now the directory forces the listed IP to the same IP that sends it the info. Since many ISPs now use content caching on port 80 (the same port that directory data comes from), a different IP address can sometimes appear in the directory. There isn't any solution for this at the moment, save having your ISP disable forced proxying of your address.
+
# D3. I'm behind a firewall/proxy. Can I still use the DNAS to broadcast?
+
# Answer: Tricky question. Users behind proxies cannot. Users behind NAT devices can, *provided* the same port the SHOUTcast Radio server runs on is set up to forward from the NAT device to the SHOUTcast Radio server. Users behind firewalls can also get a hole punched so listeners can penetrate. If broadcasters also need to get in from the outside world, you should open the hole for PortBase + 1 (i.e. id SHOUTcast Radio runs on 8000, 8001 should be open for broadcasters to get through as well.)
+
  
== SOURCE PLUG-IN ==
+
This provides a look at how the SHOUTcast v2 system is designed to work along with some examples on different configurations of the SHOUTcast tools for getting a valid SHOUTcast system ''' → [[SHOUTcast_System_Overview|SHOUTcast System Overview]]'''
  
# S1. How do I use advanced mode?
+
 
# Answer: Read the README that comes with the plug-in. It explains how to make things like crossfading, cd-audio, and voiceovers work. Also, there's a ScreenCam guide which will show exactly what to do
+
=Getting Started=
 +
 
 +
This is a step by step guide for how to get going with creating a SHOUTcast v2 system based around the provided example configuration files included with the current versions of the SHOUTcast tools and the Core documentation also provided ''' → [[SHOUTcast_Getting_Started_Guide|Getting Started Guide]]'''
 +
'''Important:''' You need to be happy with the use of command-line tools before attempting to install or run a
 +
SHOUTcast system as all versions of the v2 Server and Transcoder are designed to work as command-line tools.
 +
 
 +
Current versions of the SHOUTcast tools can be obtained from:
 +
 
 +
::'''[http://www.shoutcast.com/broadcast-tools/ Broadcast Tool Downloads]'''
 +
::or
 +
::'''[http://forums.winamp.com/showthread.php?t=324877 Support Forum Current Downloads Summary] (*)'''
 +
 
 +
The forum link is a summary page and contains links to the latest versions of the tools such as when a new
 +
release has just happened or is being tested before it is provided via the '''[http://www.shoutcast.com/broadcast-tools/ Broadcast Tool Downloads]''' page.
 +
 
 +
 
 +
==Core Documentation==
 +
 
 +
Here you can find the core documentation relating to all of the provided SHOUTcast v2 system tools which is the Server, Transcoder and Source DSP plug-in for Winamp. These contain details on the configuration options provided by these tools along with useful information on how the configuration of one tool relates to the other tools along with an specifics which may be experienced whilst using them.
 +
 
 +
::'''[[SHOUTcast_DNAS_Server_2|SHOUTcast DNAS Server 2 (sc_serv)]]'''
 +
 
 +
::'''[[SHOUTcast_DNAS_Transcoder_2|SHOUTcast DNAS Transcoder 2 (sc_trans)]]'''
 +
 
 +
::'''[[Source_DSP_Plug-in|SHOUTcast Source DSP Plug-in (dsp_sc)]]'''
 +
 
 +
 
 +
==Supporting Documentation==
 +
 
 +
Here you can find copies of additional documentation which is referenced by the core documentation such as the specific information which can go into the calendar.xml for usage with the Transcoder.
 +
 
 +
::'''[[SHOUTcast_Authhash_Management|SHOUTcast Authhash Management]]'''
 +
 
 +
::'''[[SHOUTcast_DNAS_Server_2_XML_Reponses|SHOUTcast DNAS Server 2 XML Reponses]]'''
 +
 
 +
::'''[[Source_DSP_Plug-in_Configuration_Examples|SHOUTcast Source DSP Plug-in Configuration Examples]]'''
 +
 
 +
::'''[[SHOUTcast_Transcoder_AJAX_api_Specification|SHOUTcast Transcoder AJAX api Specification]]'''
 +
 
 +
::'''[[SHOUTcast_Calendar_Event_XML_File_Specification|SHOUTcast Calendar Event XML File Specification]]'''
 +
 
 +
::'''[[SHOUTcast_YP_Nak_Errors|SHOUTcast YP Nak Error Information]]'''

Revision as of 13:34, 7 September 2011

Wiki Main | Skin Developer | Visual Developer | Plug-in Developer | Online Service Developer | SHOUTcast Tools & Services | Articles Page | FAQ | Glossary

Here you can find copies of the SHOUTcast tools documentation and other information relating to using the SHOUTcast v2 system from the tools to details about the the SHOUTcast Radio Directory API. Most of the documentation is also provided in the installers / distribution files of the different SHOUTcast v2 system tools though the versions provided here should typically contain the most up-to-date version of the documentation relating to the currently provided version of the tools.


SHOUTcast Overview

This provides a look at how the SHOUTcast v2 system is designed to work along with some examples on different configurations of the SHOUTcast tools for getting a valid SHOUTcast system SHOUTcast System Overview


Getting Started

This is a step by step guide for how to get going with creating a SHOUTcast v2 system based around the provided example configuration files included with the current versions of the SHOUTcast tools and the Core documentation also provided Getting Started Guide

Important: You need to be happy with the use of command-line tools before attempting to install or run a
SHOUTcast system as all versions of the v2 Server and Transcoder are designed to work as command-line tools.

Current versions of the SHOUTcast tools can be obtained from:

Broadcast Tool Downloads
or
Support Forum Current Downloads Summary (*)
The forum link is a summary page and contains links to the latest versions of the tools such as when a new
release has just happened or is being tested before it is provided via the Broadcast Tool Downloads page.


Core Documentation

Here you can find the core documentation relating to all of the provided SHOUTcast v2 system tools which is the Server, Transcoder and Source DSP plug-in for Winamp. These contain details on the configuration options provided by these tools along with useful information on how the configuration of one tool relates to the other tools along with an specifics which may be experienced whilst using them.

SHOUTcast DNAS Server 2 (sc_serv)
SHOUTcast DNAS Transcoder 2 (sc_trans)
SHOUTcast Source DSP Plug-in (dsp_sc)


Supporting Documentation

Here you can find copies of additional documentation which is referenced by the core documentation such as the specific information which can go into the calendar.xml for usage with the Transcoder.

SHOUTcast Authhash Management
SHOUTcast DNAS Server 2 XML Reponses
SHOUTcast Source DSP Plug-in Configuration Examples
SHOUTcast Transcoder AJAX api Specification
SHOUTcast Calendar Event XML File Specification
SHOUTcast YP Nak Error Information