SHOUTcast station directory

[doubleeaz]

Is it possible to download a directory of SHOUTcast stations? I am looking to stream the audio to an embedded player through an Ethernet or WiFi connection. I can make the connection to a station and receive and play the audio stream. The next step is to get a list of stations to make a connection to. Since this is an embedded application, it is not capable of web browsing and allowing the user to select a station as can be done from the SHOUTcast website.

Thanks for any help provided.

Rodger

[Nick@ss]

No. Afraid not.

[Tag]

Actually, yes for non-commercial purposes, for commercial use you'll need to sign a contract with our parent company.

Hit me with a private message with your intentions and I'll give you the info you need either way.

[Nick@ss]

Interesting, is this documented anywhere that i could sneak a peek?

[Tag]

Here is the complete API for newxml.phtml, for non-commerical purposes.

Top Level Genre Listing
http://yp.shoutcast.com/sbin/newxml.phtml

returns list of genres
<genrelist>
<genre name="Rock"></genre>
</genrelist>

Station List on Genre
http://yp.shoutcast.com/sbin/newxml.phtml?genre=Trance

<stationlist>
<tunein base="/sbin/tunein-station.pls"></tunein>
<station name=" -=Sputnik Radio Muzika=- Hi Def Sound..WARNING: Subliminal Suggestions in audio.... Server FULL? Do" mt="audio/aacp" id="639026" br="128" genre="Trance Dance Pop" ct="Gabriel &amp; Dresden - Sydney (Organised nature)" lc="45"></station>
</stationlist>

name = station name
mt = MIME type, determines the codec used. audio/mpeg for MP3 and audio/aacp for aacPlus
id = station ID. use this when connecting to http://yp.shoutcast.com/tunein-station.pls?id=12345 to retrieve the playlist containing the station URL
br = station bitrate
genre = station genre. This is a "freeform" text. These are used to populate the genre list. Calling the API with ?genre=xyz essential does a like genre like %xyz% database query.
ct = currently playing track. not gauranteed to be up-to-date because of database caching
lc = listener count


Station List on Search
http://yp.shoutcast.com/sbin/newxml.phtml?search=[UrlEncodedSearchString]

same results as the genre listings, but search searches station name, current playing track and genre

To limit results
add &limit=%d to limit xml entry results where %d is the number of items to return

Top 500:
Request genre=Top500



20 Random Stations

Request genre=random


RSS 2.0 version

append &rss=1 to the url

*** ALL STATION LISTS EXCEPT RANDOM, ARE SORTED BY LISTENER COUNT ***


To tune into a station, find the id="" attribute in the xml and call
http://yp.shoutcast.com/sbin/tunein-station.pls?id=1025

[Nick@ss]

Excellent stuff,

Thanks Tag, Bookmarked!!

[Jkey]

oh Nice !!

cheers Tag

[TheUnderminer]

Very helpful indeed. I have found out that it is possible to limit results to a specific bitrate and coding (the latter would be useful for some people) like so:

http://yp.shoutcast.com/sbin/newxml....dio/mpeg&br=64 (if unreadable: I appended &mt=audio/mpeg&br=64 after gentre=trance

I must say that genre listing is awfully long. Can I get a listing of mainstream genres? (max 30 I'd day).
Also, there are genres Dutch,Nederlands,Nederlandse and Nederlandstalig. The latter three translate to Dutch,Dutch (-stations) and Dutch spoken. The last two are obviously obsolete.

[gauis]

I have another question to limit the search results. &limit=20 works fine to get the first 20 stations, but how can I get the next 20 without downloading the list with &limit=40? I tried &startat=21 (as the parameter on the mainpage), but this had no effect.

[TheUnderminer]

To answer my own question: I should just make a list manually of what I think are important genres.

[liwiusz]

How can to use to automatically download/grab many PLS files from shoutcast.com and separate save in many *.PLS or *.M3U format by my category on disk for easy remote play back in winamp? I remotly works on winamp and I need to have as many playlist as internet station in my favorite category with bitrate minimum 96.

[Sawg]

You cannot. In fact if you do, you can get banned from accessing the YP all together. (XBMC used to scrape for all the PLS files, then everyone who used it (and people on their same subnet) all got banned.)

[Jkey]

liwiusz please dont double post you already
started a thread about this Here

[bob3695]

Hello,

I am working on a small application that is using the newxml.phtml and was wondering if there is a way to get "pages" of the information, i know the limit to set it to like 10 then can i do like a start at index or something so i can get from station 1-10 then when someone hits next grab station 11-21?

Thanks

[Tag]

Paging in the current API is not possible, sorry. Future 2.0 API will. Stay tuned.

[bob3695]

Is there an ETA on completion of the 2.0 API?

[Tag]

Negative, it is in the works though. That is all

[Jkey]

its nice to see you back Tag and thanks for the info

[clinko]

shoutcast.com/sbin/newxml.phtml seems to be down now. Is this related to 2.0 coming out soon?

[chuckeh]

Try http://yp.shoutcast.com/sbin/newxml.phtml now!

[clinko]

Works!

[clinko]

Scratch all that.

The problem was that Chrome (The google browser) does not render the xml. It just shows up as a blank page.

Thanks for helping either way.

[tiefens]

hi there,

could the newxml.phtml be fixed, so that the genre listing doesn't choke on the whitespaces in the genres? It always displays drum instead drum and bass, easy instead of easy listening and so on.

thanks

[Jkey]

http://www.shoutcast.com/sbin/newxml...m%20and%20Bass

http://www.shoutcast.com/sbin/newxml...sy%20Listening

Not if you use the correct format ;)

[tiefens]

hi,

ok i was unclear
i mean the genrelist listing :

http://www.shoutcast.com/sbin/newxml.phtml (without parameters)

which returns truncated genres

[Sawg]

If I remember correctly, genres are only one word, so there is multiple genre support. (i.e. "Pop Rock Emo Shit" falls into four diffrent Genre categories)

[tiefens]

http://de.wikipedia.org/wiki/Liste_der_ID3-Genres

its a german page only (didn't search too long), but it lists the id3 genre specification.
the multi genre support could be considered as broken in its current form(space as genre delimiter), xml allows a correct implementation of this

edit: those links aren't shown, i meant de.wikipedia.org/wiki/Liste_der_ID3-Genres or see the appendix of id3.org/id3v2.3.0

[Sawg]

ID3 tags and SHOUTcast are two totally unrelated things. Sure, ID3 provides a list of genres, but doesn't mean that is some magical official list that everything in the world uses.

[tiefens]

well,
let aside the opinions on standards and interoperability - shoutcast doesn't use one word genres (check "stations by genre" on the shoutcast frontpage) so the xml listing needs some simple fixing (hint: urlencoding of whitespaces)

[sirblood]

cool [IMG]http://picforyou*******img/652/x08o1101gzqw/happy0024.gif[/IMG]

[tiefens]

not cool at all.

it just sucks that the shoutcast guys can't fix even such a small but annoying bug.

[Nick@ss]

Im sure it will get looked at in time.

Remember you pay for nothing so you have no room for jumping up and down.

[tiefens]

in my eyes it's just is another example of the inferiority of closed sorce stuff, i have no possibility to fix the stuff by contributing a patch and additionally i have to let people tell me to shut up just because "i pay nothing for it".

i'm undecided what sucks more

[Nick@ss]

No one is telling you to shut up.

The yp is in Beta and there is a forum for this kind of discussion if you wish to post in it but a nicer approach will be required.

http://forums.winamp.com/showthread....hreadid=297316

As mentioned i'm sure it will get looked at in time and maybe one day you will be happy.

[dotme]

Originally posted by tiefens
in my eyes it's just is another example of the inferiority of closed sorce stuff, i have no possibility to fix the stuff by contributing a patch and additionally i have to let people tell me to shut up just because "i pay nothing for it".

i'm undecided what sucks more

Nothing needs to be fixed. I could enter a Genre of "EatMe" in my DSP and it would show up on that list you linked to.

The point is, Genres are end-user driven. Yes, the delimitor can be a space - but that means a station that lists it's Genre as "Classic Alternative Rock" would appear under searches for:

Classic Rock
Alternative
Alternative Rock
Rock

And that works.

All I'm saying is that just because you think something's broken doesn't mean it really is.

Why not develop your OWN genre list, and then conduct searches against the YP based on that? If you think this needs to be "fixed"... well, it can be fixed. On your end.

Good coders find workarounds and creative solutions, they don't rely on a giant corporation like AOL making changes to data sources.

[Jkey]

It drives me crazy when users of the free service demand changes to fit their needs.

[tiefens]

*yawn*

[Jkey]

Originally posted by tiefens
*yawn*

You seem to tired.

[SC_faisal]

Please go to http://www.shoutcast.com/partners and click on the Become a Partner Link for all partner requests and people on our team will get back to you.

http://www.shoutcast.com/partners

f.

[Killzone_Kid]

Originally posted by Tag

20 Random Stations

Request genre=random

Thanks for the info Tag. About random, this works too:

Request %d random stations: newxml.phtml?random=%d


Also 'limit' doesn't work properly. One would think all it does is limits number of results returned, but it doesn't always work, here is the problem: http://forums.winamp.com/showthread....hreadid=302047

KK