[Icecast-dev] Icecast Server API

"Rücker, Thomas" thomas.ruecker at tieto.com
Thu Feb 28 08:02:52 PST 2013


Hi Richard,

On 25/02/13 10:57, Richard Schülein wrote:
>
> Hi,
>
> i know, that i maybe break all rules regarding mailing lists etc, but 
> I hope, I can get an answer from you for this question:
>

Aside from posting a HTML mail you're doing just fine and your question 
is very much in the right place. ;)


> Is there an API do received the current listed stations?
>
> We want to implement Icecast into a audioplayer and for that we have 
> to download the current stations list (is that allowed?)
>

http://dir.xiph.org/yp.xml
Is the current URL for a XML representation of the Icecast directory we 
run at Xiph.
Please note that as Ralph pointed out implementing proper compression on 
http level is expected from new implementations. It compresses the XML 
down to about 10% of its size and as such also makes for a faster download.

There is currently no strict specification for the XML, while I do not 
expect major changes, you never know though.


> So I’m searching similar function like Shoutcast offers:
>
> *Description:*Get top 500 stations on SHOUTcast Radio directory.
>
> *URL:*http://api.shoutcast.com/legacy/Top500?k=[Your Dev ID]
>

We do not offer that currently. You can easily do things based on the 
full XML on the client side though.
We have a ticket open debating how an API could look in the future.
https://trac.xiph.org/ticket/1905
We'd appreciate input and thoughts from real world implementers.

Hope that helps.

Cheers

Thomas

PS: please consider subscribing to the mailing list.
http://lists.xiph.org/mailman/listinfo/icecast-dev


More information about the Icecast-dev mailing list