For industry group 24/7 multiple station monitoring and recording, please contact sales@dar.fm.

go

Radio Show Chart

Record Show Button

Record Station Button

Stream Record API

Radio Show Chart

Webmasters and special interest bloggers - add value to your page and engage your readers with an interactive chart of radio shows on your chosen topic. With just a click, readers can select and record shows for listening at a time and place convenient for them.

  1. Select a show topic from the category list below. Change the Setting if you prefer a longer or shorter chart.
  2. A few lines of code will then be displayed - include that in your website and your readers will find an interactive Show Chart that allows them to choose and record the most popular radio shows for your topic. (If unfamiliar with adding HTML code to your web site please talk to your web site administrator for assistance.)
  3. Clicking the record button next to each show title will initiate a recording of all future broadcasts that the user can listen to on a computer or smart phone.

Select a radio show category:

Number of shows to display:


Paste this text into the website:

Preview:

Promote A Radio Show Using Record Show Button

If you're a radio show personality or a radio station or even a fan site now here's a free service which will increase your audience. Invite your listeners to record every broadcast for listening at a time and place convenient for them! Using this free service listeners who aren't able to tune in can still catch your show. To begin:

  1. Select the show from the list below
  2. A few lines of code will then be displayed - include that in your website and fans will have a convenient "Record This Show" button to click:

    (If unfamiliar with adding HTML code to your web site please talk to your web site administrator for assistance.) If your show is not listed please submit it to be added here.
  3. When clicked it will initiate a recording of all future broadcasts that the user can listen to on a computer or smart phone.

Choose the name of the show that the button will record:

Paste this text into the website:

Preview and test your button:

Select show and click "Create custom Record button".

TIPS:

If the desired show is not listed please submit it to show index here. This will require providing the station URL.

Please test the recording before announcing it. If there are any issues please let us know here.



Record Station Button

If you're a radio show personality or a radio station or even a fan site now here's a free service which will increase your audience. Invite your listeners to record every broadcast for listening at a time and place convenient for them! Using this free service listeners who aren't able to tune in can still catch your show. To begin:

  1. Select the station from the list below
  2. A few lines of code will then be displayed - include that in your website and listeners will have a convenient "Record This Station" button to click:

    (If unfamiliar with adding HTML code to your web site please talk to your web site administrator for assistance.) If your station is not listed please submit it to be added here.
  3. When clicked it will initiate a 2 hour recording starting immediately that the user can listen to on a computer or smart phone.

Choose the station that the button will record:

Paste this text into the website:

Preview and test your button:

Select station and click "Create custom Record button".

TIPS:

If the desired station is not listed please submit it to the station index here. This will require providing the stream URL.

Please test the recording before announcing it. If there are any issues please let us know here.



Stream Record API

Allows you to record an Internet radio stream and pass the file to a third party storage site.


Example Requests (recording stations):

MUSIC Station

Station name: Hot 97
Call letters: WQHT
Style/format: Music
URL: https://provisioning.streamtheworld.com/pls/WQHTFM.pls
Duration: 60 minutes
User account: joeuser@domain.com

API call to record:

Example of how it might look on a page:

Record Record WQHT

HTML Source code:

Parameters:

user_email (required): Uses this email as DAR.fm account, creates it if one doesn't exist. Maximum 100 characters. Must be in standard format: username@domain.tld

stream_url (required): Station to be recorded. Maximum 250 characters. Must be Icecast / Shoutcast format ending in .pls or .m3u.

partner_token (required): The third party storage partner requires this value. You can use: 4416226356 or create your own partner token on their web site.

format_id (optional): A numeric value which identifies the type of content being recorded. Valid options are: 101 (talk radio: will break the file into 15 minute chunks) or 103 (music). Default is 103.

source_name (optional): Friendly name of station, spaces are OK (Example: 'Power 103'). Maximum 100 characters.

call_sign (optional): Call letters of the radio station that is being recorded (Examples: KFUN, WABT or Jazz88.3). Default is 'unknown'. Maximum 20 characters.

show_title (optional): The name of the show being recorded. (Example: 'The Glenn Beck Program'). Maximum 100 characters.

start_time (optional): Time when the recording should start. Valid options are: GMT YYYY-MM-DD 24:00:00, or now (all lower case). Default is now.

duration (optional): The number of minutes that you want to record. This should be a natural number (Examples: 60, 120, 180, 240, or 300). Default is 240.

frequency (optional): How often the show should be recorded. Default is 'once'. Valid options are:



stream_type (optional): Another way to categorize and break up content being recorded. Valid options are: solid, chunk, and unknown. You should set to 'solid' for streams which do not contain meta data (ID3 tags). You should set to 'chunk' for streams that do contain meta data (ID3 tags). If you are not sure you can set it to 'unknown' which will cause DAR.fm to look at the format_id value. The system will use 'chunk' for 103 and 'solid' for 101. The default is 'unknown'.




Example Response From Server:

<mp3tunes xml:space="preserve">
<record_job_id>12393</record_job_id>
</mp3tunes>



Sample PHP Code

$url = "";
$url .= "http://ws.mp3tunes.com/api/v1/streamRecord?output=xml";
$url .= "&user_email=" . urlencode ( $this->user_email );
$url .= "&stream_url=" . urlencode ( $this->stream_url );
$url .= "&partner_token=" . urlencode ( $this->partner_token );
$url .= "&start_time=" . urlencode ( $this->start_time );
$url .= "&duration=" . urlencode ( $this->duration );
$url .= "&show_title=" . urlencode ( $this->show_title );
$url .= "&format_id=" . urlencode ( $this->format_id );
$url .= "&call_sign=" . urlencode ( $this->call_sign );
$url .= "&frequency=" . urlencode ( $this->frequency );
$url .= "&stream_type=" . urlencode ( $this->stream_type );


Additional Information

For more information on how to retrieve information from a storage locker and play it back please see: MP3tunes Media API. If have specific developer questions please contact us.


go

See missing stations or shows? Want to make corrections?
Now you can change the guide and make DAR.fm better for everyone.