SHOUTcast Listing Requirements

From Winamp Developer Wiki
Jump to: navigation, search

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


How to get listed in the SHOUTcast Directory

There are currently a number of ways for a station to be listed in the SHOUTcast Directory (also referred to as the YP) which this document will detail. If you are still uncertain whether your station can be listed in the SHOUTcast Directory, please contact support with information about your existing station and they will be able to advise you.


SHOUTcast DNAS Server

This is the primary way for getting your station listed in the SHOUTcast Directory. To do this, you need to ensure the stream is marked as public and for all 2.x DNAS you have to have a valid authhash (see SHOUTcast Authhash Management for what to do if you are having issues obtaining an authhash for your stream(s)).


For the legacy 1.x DNAS (using the 2.x DNAS is preferred over the 1.x DNAS), you just need to ensure the stream is marked as public.


Ensuring the stream is correctly marked as public can be done either via the connected stream source and the options it provides or it can be done by forcing the DNAS via the publicserver configuration option which if set as publicserver=always will override what is provided by the the connected stream source (be that a direct source or a relay source).


Icecast Server

Important Update 2017

Icecast stations are no longer listed in the SHOUTcast Directory

As a result of all DNAS v1.x streams no longer being listed due to a vulnerability issue which caused Chrome, Safari and other browsers to remove support, Icecast streams (which use v1 protocol listing method) are also no longer listed.


Original Text

This is an alternative server to the SHOUTcast DNAS server which can be configured to be able to be listed in the SHOUTcast Directory as a SHOUTcast 1.x DNAS compatible listing. Such listings will work but due to a lower set of information provided by the Icecast server on its communication with the SHOUTcast Directory, some aspects of the listings will not be provided and can only be enabled for native SHOUTcast DNAS servers.

If an Icecast server instance has been modified so that
it is not reported as being an Icecast server then it
may not be listed. Check the Icecast logs for errors if
you cannot find the listing in the SHOUTcast Directory.


To get the Icecast server configured to be listed, the following needs to be added to your Icecast server configuration file:

    <directory>
        <yp-url-timeout>15</yp-url-timeout>
        <yp-url>http://yp.shoutcast.com</yp-url>
    </directory>


Once the above configuration options are present, as long as the Icecast server is able to see the SHOUTcast Directory server and the information it provides passes validation (as only MP3 and AAC based streams can be listed), then the stream should be listed.


If needing to include multiple Icecast servers as part of a clustered stream, the station name, genre and website details all need to be the same, otherwise the SHOUTcast Directory may not cluster them correctly together (which can still happen even if the details are correct due to how 1.x DNAS style clustering works).


Note: We do not support sending manual updates for the Icecast server like is supported by the Icecast Directory. Each Icecast server to be listed in the SHOUTcast Directory needs to directly provide the required information to the SHOUTcast Directory servers and not doing this can lead to you being banned from being listed in the SHOUTcast Directory.

Radionomy Group Services / SHOUTcast Streaming Service

If using any of these services then your station will either be automatically added into the SHOUTcast Directory or will require you to reach a specific number of total listening hours (TLH) before your station is imported into the SHOUTcast Directory. This depends on the service being used as to whether the TLH requirement needs to be met or whether you are automatically imported into the SHOUTcast Directory.