Icecast dev - Aug 2012 - need API doc to develop a radio client

Hi,



I want to develop a streaming client application which will use Icecast server
to receive the stream and play the radio stations. But I have not found any API
documentation as available in case of SHOUTcast server. Can you please provide
any api documentation or link which describes the things below:



1) How to connect with the Icecast server

2) How to get the station list from the server

3) how to get the playlist

4) How to play a radio station

5) How to fetch the metadata information.



Thank you in advance.



Regards,

Sanjay

Please do not print this email unless it is absolutely necessary. 

The information contained in this electronic message and any attachments to this
message are intended for the exclusive use of the addressee(s) and may contain
proprietary, confidential or privileged information. If you are not the intended
recipient, you should not disseminate, distribute or copy this e-mail. Please
notify the sender immediately and destroy all copies of this message and any
attachments.

WARNING: Computer viruses can be transmitted via email. The recipient should
check this email and any attachments for the presence of viruses. The company
accepts no liability for any damage caused by any virus transmitted by this
email.

www.wipro.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL:
http://lists.xiph.org/pipermail/icecast-dev/attachments/20120827/376ad853/attachment.htm

2012/8/27 <sanjay.girigoswami at wipro.com>
>
>  The information contained in this electronic message and any attachments
> to this message are intended for the exclusive use of the addressee(s) and
> may contain proprietary, confidential or privileged information. If you are
> not the intended recipient, you should not disseminate, distribute or copy
> this e-mail. Please notify the sender immediately and destroy all copies of
> this message and any attachments.
>
> WARNING: Computer viruses can be transmitted via email. The recipient
> should check this email and any attachments for the presence of viruses.
> The company accepts no liability for any damage caused by any virus
> transmitted by this email.
>
> www.wipro.com
>
Sorry i am not sure if i am allowed to read this email , but i will not
print it out;)))

If you klick on this link you might get the information you want.

http://bit.ly/NWJ1aF

cheers


-- 
Marc Manthey
50823 K?ln, germany
Vogelsangerstr.97
Phone: 0049-221-29891489
Mobile : 0049-1577-3329231
Website: http://let.de
Email: marc at let.de
-------------- next part --------------
An HTML attachment was scrubbed...
URL:
http://lists.xiph.org/pipermail/icecast-dev/attachments/20120827/d69546dc/attachment.htm

On 12-08-27 6:18 AM, sanjay.girigoswami at wipro.com wrote:
> 1) How to connect with the Icecast server
One connects to an icecast server over normal http.
> 2) How to get the station list from the server
By default the icecast server returns an html version of the station
list. You can try interpreting that, for example looking for stream or
playlist urls.

An xml version is available from e.g. admin/stats or admin/listmounts,
but this requires basic auth with the administrator username and
password as set in the config file.

Why xml variants aren't available on the public page, I don't know.

Individual icecast servers can also post their station lists to a
directory server. You can retrieve a machine-readable version of this
list from http://dir.xiph.org/yp.xml
> 3) how to get the playlist
Just request the mountpoint with a playlist extension. For example, to
get a playlist wrapper around
http://ec2-50-112-77-171.us-west-2.compute.amazonaws.com:8000/clock.opus, ask
for
http://ec2-50-112-77-171.us-west-2.compute.amazonaws.com:8000/clock.opus.m3u
> 4) How to play a radio station
You need to download the http stream and feed it to an audio decoder.
For example, you can do this in html5 with:

<audio
src="http://ec2-50-112-77-171.us-west-2.compute.amazonaws.com:8000/clock.opus">
</audio>
> 5) How to fetch the metadata information.
Metadata is sent inline with the stream. Unfortunately there's no server
api to query this separately, beyond what's in the mountpoint listing.

On 12-08-27 8:55 AM, Marc wrote:
> If you klick on this link you might get the information you want.
>
> http://bit.ly/NWJ1aF
Please don't use url shorteners. The obscure the history (and
provenance) of your link.

Additionally, I don't find many of these questions easy to answer at all
from the icecast documentation. There's documentation for the config
file options, but nothing about the server APIs or how https streaming
works.


Hope that helps,
 -r

2012/8/27 Ralph Giles <giles at thaumas.net>
>
> > http://bit.ly/NWJ1aF
>
> Please don't use url shorteners. The obscure the history (and
> provenance) of your link.
>
Sorry , it wasnt ment to be rude, but his email footers made me smile,
because its a public list and url shorteners are the most common tools on
the internet nowadays. and bit.ly
is on of the most popular and uses its own spam and malware protection
mechanism.


http://blog.bitly.com/post/263859706/spam-and-malware-protection



>
> Additionally, I don't find many of these questions easy to answer at
all
> from the icecast documentation. There's documentation for the config
> file options, but nothing about the server APIs or how https streaming
> works.
>

Thanks for your great advise

greetings
>
>
> Hope that helps,
>  -r
>
> _______________________________________________
> Icecast-dev mailing list
> Icecast-dev at xiph.org
> http://lists.xiph.org/mailman/listinfo/icecast-dev
>


-- 
Marc Manthey
50823 K?ln, germany
Vogelsangerstr.97
Phone: 0049-221-29891489
Mobile : 0049-1577-3329231
Website: http://let.de
Email: marc at let.de
-------------- next part --------------
An HTML attachment was scrubbed...
URL:
http://lists.xiph.org/pipermail/icecast-dev/attachments/20120827/5c5ce74f/attachment.htm

On Mon, Aug 27, 2012 at 11:46:28AM -0700, Ralph Giles
wrote:
> On 12-08-27 6:18 AM, sanjay.girigoswami at wipro.com wrote:
> 
> > 2) How to get the station list from the server
> 
> By default the icecast server returns an html version of the station
> list. You can try interpreting that, for example looking for stream or
> playlist urls.
> 
> An xml version is available from e.g. admin/stats or admin/listmounts,
> but this requires basic auth with the administrator username and
> password as set in the config file.
> 
> Why xml variants aren't available on the public page, I don't know.
> 
Well, you can add any XSLT template in non-authenticated directory and fetch
the data from there. E.g. I have a template which exports all mount points
as one M3U playlist. If you are interrested, I can post it.

-- Petr
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 230 bytes
Desc: not available
Url :
http://lists.xiph.org/pipermail/icecast-dev/attachments/20120827/fa658d28/attachment.pgp

<sanjay.girigoswami <at> wipro.com> writes:
> 
> 
> 
> Hi,
> ?
> I want to develop a streaming client application which will use Icecast 
server to receive the stream and play the radio stations. But I have not found 
any API documentation as available in case of SHOUTcast server. Can you please 
provide any api documentation
>  or link which describes the things below:
> ?
> 1) How to connect with the Icecast server
> 2) How to get the station list from the server
> 3) how to get the playlist
> 4) How to play a radio station
> 5) How to fetch the metadata information.
> ?
> Thank you in advance.
> ?
> Regards,
> Sanjay
> 
>  Please do not print this email unless it is absolutely necessary. 
> 
> 
>  The information contained in this electronic message and any attachments
to
this message are intended for the exclusive use of the addressee(s) and may 
contain proprietary, confidential or privileged information. If you are not 
the intended recipient, you should not disseminate, distribute or copy this e-
mail. Please notify the sender immediately and destroy all copies of this 
message and any attachments. 
> 
> WARNING: Computer viruses can be transmitted via email. The recipient
should
check this email and any attachments for the presence of viruses. The company 
accepts no liability for any damage caused by any virus transmitted by this 
email. 
> 
> www.wipro.com
> 
> 
> 
> _______________________________________________
> Icecast-dev mailing list
> Icecast-dev <at> xiph.org
> http://lists.xiph.org/mailman/listinfo/icecast-dev
> 

 Hello,
Can you please share a sample client application code which uses Icecast 
server to retrieve the station list and playing a radio station.

Thanks,
Sanjay

Hi,



I want to develop a streaming client application in LINUX platform which will
use Icecast server to receive the stream and play the radio stations.

The purpose of the application would be:



*         connect with the Icecast server

*         get the station list from the server

*         get the playlist

*         play a radio station

*         fetch the metadata information.



Now my questions are:



1)      What will be the entry point for Icecast server

In case of SHOUTcast server, The entry point is "Genre". The Radio
client first retrieves the genre list from the server and then get station list
for each genre.



2)      Where do I find the query strings which will be sent to server to get
the station list, play list url etc.

For example, in case of SHOUTcast server we send the below query to get the
station list by Genre:

http://api.shoutcast.com/legacy/genresearch?(DEV
Id)&genre<http://api.shoutcast.com/legacy/genresearch?(DEV%20Id)&genre>=(Genre
name)



3)      Can you please share a sample client application code which uses Icecast
server to retrieve the station list and play a station.





Thank you in advance.



Regards,

Sanjay

Please do not print this email unless it is absolutely necessary. 

The information contained in this electronic message and any attachments to this
message are intended for the exclusive use of the addressee(s) and may contain
proprietary, confidential or privileged information. If you are not the intended
recipient, you should not disseminate, distribute or copy this e-mail. Please
notify the sender immediately and destroy all copies of this message and any
attachments.

WARNING: Computer viruses can be transmitted via email. The recipient should
check this email and any attachments for the presence of viruses. The company
accepts no liability for any damage caused by any virus transmitted by this
email.

www.wipro.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL:
http://lists.xiph.org/pipermail/icecast-dev/attachments/20120829/da5e88d0/attachment.htm