Old 7th August 2008, 16:28   #1
doubleeaz
Junior Member
 
Join Date: Aug 2008
Location: Chandler, Arizona
Posts: 1
SHOUTcast station directory

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
doubleeaz is offline   Reply With Quote
Old 7th August 2008, 17:02   #2
Nick@ss
Moderator
 
Nick@ss's Avatar
 
Join Date: Nov 2004
Location: Streamsolutions Headquarters
Posts: 11,953
No. Afraid not.
Nick@ss is offline   Reply With Quote
Old 7th August 2008, 17:32   #3
Tag
Streaming Media Expert
 
Tag's Avatar
 
Join Date: Apr 2000
Location: Fort Collins, Colorado
Posts: 143
Send a message via AIM to 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.

Powered by Redbull and Progressive House
Tag is offline   Reply With Quote
Old 7th August 2008, 17:49   #4
Nick@ss
Moderator
 
Nick@ss's Avatar
 
Join Date: Nov 2004
Location: Streamsolutions Headquarters
Posts: 11,953
Interesting, is this documented anywhere that i could sneak a peek?
Nick@ss is offline   Reply With Quote
Old 7th August 2008, 18:32   #5
Tag
Streaming Media Expert
 
Tag's Avatar
 
Join Date: Apr 2000
Location: Fort Collins, Colorado
Posts: 143
Send a message via AIM to 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

Powered by Redbull and Progressive House
Tag is offline   Reply With Quote
Old 7th August 2008, 19:02   #6
Nick@ss
Moderator
 
Nick@ss's Avatar
 
Join Date: Nov 2004
Location: Streamsolutions Headquarters
Posts: 11,953
Excellent stuff,

Thanks Tag, Bookmarked!!
Nick@ss is offline   Reply With Quote
Old 7th August 2008, 22:49   #7
Jkey
Forum King
 
Join Date: Jul 2004
Location: E*arth
Posts: 3,035
oh Nice !!

cheers Tag

So Long, and Thanks for All the Fish.
Jkey is offline   Reply With Quote
Old 18th August 2008, 10:55   #8
TheUnderminer
Junior Member
 
Join Date: Aug 2008
Location: Netherlands
Posts: 2
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.
TheUnderminer is offline   Reply With Quote
Old 23rd August 2008, 09:55   #9
gauis
Junior Member
 
Join Date: Aug 2008
Posts: 1
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.
gauis is offline   Reply With Quote
Old 23rd August 2008, 10:06   #10
TheUnderminer
Junior Member
 
Join Date: Aug 2008
Location: Netherlands
Posts: 2
To answer my own question: I should just make a list manually of what I think are important genres.
TheUnderminer is offline   Reply With Quote
Old 3rd September 2008, 18:06   #11
liwiusz
Junior Member
 
liwiusz's Avatar
 
Join Date: Sep 2008
Location: Poland
Posts: 4
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.
liwiusz is offline   Reply With Quote
Old 3rd September 2008, 20:23   #12
Sawg
Forum King
 
Join Date: Jun 2000
Location: Phoenix, AZ
Posts: 7,456
Send a message via ICQ to Sawg Send a message via AIM to Sawg Send a message via Yahoo to 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.)

| Brought to you by ^V ^C | The one... the original... no seriously!
Sawg is offline   Reply With Quote
Old 4th September 2008, 07:46   #13
Jkey
Forum King
 
Join Date: Jul 2004
Location: E*arth
Posts: 3,035
liwiusz please dont double post you already
started a thread about this Here

So Long, and Thanks for All the Fish.
Jkey is offline   Reply With Quote
Old 19th September 2008, 20:05   #14
bob3695
Junior Member
 
Join Date: Sep 2008
Posts: 3
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
bob3695 is offline   Reply With Quote
Old 19th September 2008, 20:06   #15
Tag
Streaming Media Expert
 
Tag's Avatar
 
Join Date: Apr 2000
Location: Fort Collins, Colorado
Posts: 143
Send a message via AIM to Tag
Paging in the current API is not possible, sorry. Future 2.0 API will. Stay tuned.

Powered by Redbull and Progressive House
Tag is offline   Reply With Quote
Old 19th September 2008, 20:27   #16
bob3695
Junior Member
 
Join Date: Sep 2008
Posts: 3
Is there an ETA on completion of the 2.0 API?
bob3695 is offline   Reply With Quote
Old 19th September 2008, 20:27   #17
Tag
Streaming Media Expert
 
Tag's Avatar
 
Join Date: Apr 2000
Location: Fort Collins, Colorado
Posts: 143
Send a message via AIM to Tag
Negative, it is in the works though. That is all

Powered by Redbull and Progressive House
Tag is offline   Reply With Quote
Old 19th September 2008, 20:39   #18
Jkey
Forum King
 
Join Date: Jul 2004
Location: E*arth
Posts: 3,035
its nice to see you back Tag and thanks for the info

So Long, and Thanks for All the Fish.
Jkey is offline   Reply With Quote
Old 20th September 2008, 16:52   #19
clinko
Junior Member
 
clinko's Avatar
 
Join Date: Sep 2003
Posts: 17
Send a message via AIM to clinko
shoutcast.com/sbin/newxml.phtml

shoutcast.com/sbin/newxml.phtml seems to be down now. Is this related to 2.0 coming out soon?
clinko is offline   Reply With Quote
Old 20th September 2008, 17:05   #20
chuckeh
SHOUTcast Freak
 
chuckeh's Avatar
 
Join Date: Jun 2004
Location: NRW, Germany
Posts: 323
Try http://yp.shoutcast.com/sbin/newxml.phtml now!
chuckeh is offline   Reply With Quote
Old 20th September 2008, 17:16   #21
clinko
Junior Member
 
clinko's Avatar
 
Join Date: Sep 2003
Posts: 17
Send a message via AIM to clinko
Works!
clinko is offline   Reply With Quote
Old 20th September 2008, 17:18   #22
clinko
Junior Member
 
clinko's Avatar
 
Join Date: Sep 2003
Posts: 17
Send a message via AIM to 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.
clinko is offline   Reply With Quote
Old 7th November 2008, 18:24   #23
tiefens
Junior Member
 
Join Date: Nov 2008
Posts: 8
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
tiefens is offline   Reply With Quote
Old 8th November 2008, 07:34   #24
Jkey
Forum King
 
Join Date: Jul 2004
Location: E*arth
Posts: 3,035
http://www.shoutcast.com/sbin/newxml...m%20and%20Bass

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

Not if you use the correct format ;)

So Long, and Thanks for All the Fish.
Jkey is offline   Reply With Quote
Old 8th November 2008, 09:56   #25
tiefens
Junior Member
 
Join Date: Nov 2008
Posts: 8
hi,

ok i was unclear
i mean the genrelist listing :

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

which returns truncated genres
tiefens is offline   Reply With Quote
Old 8th November 2008, 09:59   #26
Sawg
Forum King
 
Join Date: Jun 2000
Location: Phoenix, AZ
Posts: 7,456
Send a message via ICQ to Sawg Send a message via AIM to Sawg Send a message via Yahoo to 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)

| Brought to you by ^V ^C | The one... the original... no seriously!
Sawg is offline   Reply With Quote
Old 8th November 2008, 10:09   #27
tiefens
Junior Member
 
Join Date: Nov 2008
Posts: 8
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
tiefens is offline   Reply With Quote
Old 8th November 2008, 10:20   #28
Sawg
Forum King
 
Join Date: Jun 2000
Location: Phoenix, AZ
Posts: 7,456
Send a message via ICQ to Sawg Send a message via AIM to Sawg Send a message via Yahoo to 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.

| Brought to you by ^V ^C | The one... the original... no seriously!
Sawg is offline   Reply With Quote
Old 8th November 2008, 10:46   #29
tiefens
Junior Member
 
Join Date: Nov 2008
Posts: 8
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)
tiefens is offline   Reply With Quote
Old 22nd December 2008, 17:24   #30
tiefens
Junior Member
 
Join Date: Nov 2008
Posts: 8
not cool at all.

it just sucks that the shoutcast guys can't fix even such a small but annoying bug.
tiefens is offline   Reply With Quote
Old 22nd December 2008, 17:38   #31
Nick@ss
Moderator
 
Nick@ss's Avatar
 
Join Date: Nov 2004
Location: Streamsolutions Headquarters
Posts: 11,953
Im sure it will get looked at in time.

Remember you pay for nothing so you have no room for jumping up and down.
Nick@ss is offline   Reply With Quote
Old 22nd December 2008, 18:09   #32
tiefens
Junior Member
 
Join Date: Nov 2008
Posts: 8
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
tiefens is offline   Reply With Quote
Old 22nd December 2008, 18:24   #33
Nick@ss
Moderator
 
Nick@ss's Avatar
 
Join Date: Nov 2004
Location: Streamsolutions Headquarters
Posts: 11,953
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.
Nick@ss is offline   Reply With Quote
Old 22nd December 2008, 18:56   #34
dotme
Moderator
 
dotme's Avatar
 
Join Date: Feb 2005
Location: USA
Posts: 4,020
Quote:
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.
dotme is offline   Reply With Quote
Old 23rd December 2008, 10:58   #35
Jkey
Forum King
 
Join Date: Jul 2004
Location: E*arth
Posts: 3,035
It drives me crazy when users of the free service demand changes to fit their needs.

So Long, and Thanks for All the Fish.
Jkey is offline   Reply With Quote
Old 23rd December 2008, 11:51   #36
tiefens
Junior Member
 
Join Date: Nov 2008
Posts: 8
*yawn*
tiefens is offline   Reply With Quote
Old 23rd December 2008, 11:57   #37
Jkey
Forum King
 
Join Date: Jul 2004
Location: E*arth
Posts: 3,035
Quote:
Originally posted by tiefens
*yawn*
You seem to tired.

So Long, and Thanks for All the Fish.
Jkey is offline   Reply With Quote
Old 12th January 2009, 17:32   #38
SC_faisal
SHOUTcast (Alumni)
 
Join Date: Sep 2008
Posts: 163
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.
SC_faisal is offline   Reply With Quote
Old 14th January 2009, 13:07   #39
Killzone_Kid
Member
 
Join Date: Jan 2009
Posts: 88
Quote:
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
Killzone_Kid is offline   Reply With Quote
Old 27th January 2009, 13:45   #40
BatteryCell
Junior Member
 
Join Date: Jan 2009
Posts: 1
Quote:
Originally posted by 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
Just wanted to say thanks for this, I've been looking for something straightforward like this for months.
BatteryCell is offline   Reply With Quote
Reply
Go Back   Winamp & SHOUTcast Forums > SHOUTcast > SHOUTcast Discussions

Thread Tools Search this Thread
Search this Thread:

Advanced Search
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump