Promoting Your Station

There are many directories around the Web where users can find new radio stations to listen to. This page documents how to integrate your AzuraCast station with these directories.

Webhook-Based Directories

These directories support any broadcast technology and receive “Now Playing” metadata updates via a custom API, which we implement in AzuraCast via our Web Hooks feature.

TuneIn AIR

AzuraCast supports sending automatic metadata updates to TuneIn’s AIR broadcasting API via a Web Hook.

You will first need a station ID from TuneIn. Contact them directly for more information about signing up for an API account.

Once you have a station ID, you can create a new web hook via the Web Hooks station sidebar menu inside AzuraCast.

Radio.de

AzuraCast supports sending automatic metadata updates to Radio.de’s Metadata Push API as of Version 0.19.1.

You should first contact the Radio.de team directly to gain access to the API. Once you have the necessary credentials, you can create a new web hook via the Web Hooks station sidebar inside AzuraCast.

GetMeRadio

AzuraCast supprots sending automatic metadata updates to GetMeRadio as of Version 0.19.2.

Contact the GetMeRadio team first to gain access to their API. Once you have the necessary credentials, you can create a new web hook via the Web Hooks station sidebar inside AzuraCast.

YellowPages Directories

These directories use Icecast’s built-in YellowPages (YP) discovery mechanism to submit routine updates. They require using Icecast to broadcast rather than Shoutcast or HLS.

Xiph Icecast Directory

Xiph, the maintainers of Icecast, also maintain a public directory of stations at dir.xiph.org.

To add your station to the directory, edit your station’s profile, then under the “Broadcasting” tab, you will find “Custom Configuration” at the bottom of the page.

You can add the following entry to broadcast to the Xiph directory:

<directory>
  <yp-url-timeout>15</yp-url-timeout>
  <yp-url>http://dir.xiph.org/cgi-bin/yp-cgi</yp-url>
</directory>

Internet-radio.com

The station directory at internet-radio.com supports and recommends using Icecast’s YellowPages directory to manage your station listing on their web site. Their forum includes specific instructions for Icecast.

To integrate the custom directory code into AzuraCast, edit your station’s profile, then under the “Broadcasting” tab, you will find “Custom Configuration” at the bottom of the page.

You can add the following entry:

<directory>
  <yp-url-timeout>15</yp-url-timeout>
  <yp-url>http://icecast-yp.internet-radio.com</yp-url>
</directory>

Icecast Header Directories

These directories receive metadata updates via custom headers provided directly in your Icecast stream. They require using Icecast to broadcast rather than Shoutcast or HLS.

radio-browser.info

First, review the Station owner instructions on the directory web site.

To add custom headers to a station, open the Broadcasting sidebar menu, then click Mount Points. Click Edit on a mount point, and supply the custom headers in the advanced configuration for the mount point:

<http-headers>
  <header name="icy-index-metadata" value="1" />
  <header name="icy-logo" value="https://example.com/besticon.png" />
  <header name="icy-country-code" value="at" />
  <header name="icy-country-subdivision-code" value="at-1" />
  <header name="icy-language-codes" value="en,de" />
  <header name="icy-main-stream-url" value="http://example.com:8000/teststream" />
  <header name="icy-geo-lat-long" value="12.345,-23.456" />
</http-headers>