[icecast-dev] official communication protocol definition / documentation?

Michael Smith msmith at xiph.org
Sun Feb 8 16:47:36 PST 2004

On Sunday 08 February 2004 18:19, Enrico Minack wrote:
> Hello,
> I am looking for a documentation of the communication protocolls icecast is
> capable of: ICY, XAUDIOCAST and a modified HTTP. In order to write client
> software being capable of all available features I was searching on the net
> for those documentations but no luck so far. How come? Isn't this protocoll
> documented? How does the developer team know what options and functins are
> available in the protocoll? Just by the already written code?

We should fully document our main source protocol - which is a slightly 
modified HTTP, but haven't. Sorry about that. I'll cover it later in this 

The other protocols are supported solely for backwards compatibility with 
older systems - you should refer to documentation for those systems for 
protocol details.

For icecast 2, the primary source protocol is HTTP, with one modification: a 
new HTTP method, "SOURCE", is introduced. When a SOURCE request is received, 
icecast2 adds the incoming stream as a mountpoint using the request-URI in 
the SOURCE request. The request must be authenticated using HTTP BASIC auth. 
That's all there it to it!

There's also some stuff for compatibility with other systems (icecast 1.x, 
shoutcast) for mp3 metadata - this isn't documented by us either, but is 
widely documented elsewhere (search for 'mp3 shoutcast metadata protocol').


--- >8 ----
List archives:  http://www.xiph.org/archives/
icecast project homepage: http://www.icecast.org/
To unsubscribe from this list, send a message to 'icecast-dev-request at xiph.org'
containing only the word 'unsubscribe' in the body.  No subject is needed.
Unsubscribe messages sent to the list will be ignored/filtered.

More information about the Icecast-dev mailing list