Kamaelia docs : Kamaelia.Protocol.HTTP.IcecastClient

Icecast/SHOUTcast MP3 streaming client

This component uses HTTP to stream MP3 audio from a SHOUTcast/Icecast server.

IcecastClient fetches the combined audio and metadata stream from the HTTP server hosting the stream. IcecastDemux separates the audio data from the metadata in stream and IcecastStreamWriter writes the audio data to disk (discarding metadata).

Example Usage

Receive an Icecast/SHOUTcast stream, demultiplex it, and write it to a file:

pipeline(
    IcecastClient("http://64.236.34.97:80/stream/1049"),
    IcecastDemux(),
    IcecastStreamWriter("stream.mp3"),
).run()

How does it work?

The SHOUTcast/Icecast protocol is virtually identical to HTTP. As such, IcecastClient subclasses SingleShotHTTPClient modifying the request slightly to ask for stream metadata(e.g. track name) to be included (by adding the icy-metadata header). It is otherwise identical to its parent class.


Kamaelia.Protocol.HTTP.IcecastClient.IcecastClient

class IcecastClient(SingleShotHTTPClient)

IcecastClient(starturl) -> Icecast/SHOUTcast MP3 streaming component

Arguments: - starturl -- the URL of the stream

Methods defined here

formRequest(self, url)

Overrides the standard HTTP request with an Icecast/SHOUTcast variant which includes the icy-metadata header required to get metadata with the stream

Kamaelia.Protocol.HTTP.IcecastClient.IcecastDemux

class IcecastDemux(Axon.Component.component)

Splits a raw Icecast stream into A/V data and metadata

Methods defined here

dictizeMetadata(self, metadata)

Convert metadata that was embedded in the stream into a dictionary.

Kamaelia.Protocol.HTTP.IcecastClient.IcecastStreamRemoveMetadata

prefab: IcecastStreamRemoveMetadata

Kamaelia.Protocol.HTTP.IcecastClient.IcecastStreamWriter

class IcecastStreamWriter(Axon.Component.component)

Inboxes

  • control : UNUSED
  • inbox : Icecast stream

Outboxes

  • outbox : UNUSED
  • signal : UNUSED

Methods defined here

Feedback

Got a problem with the documentation? Something unclear that could be clearer? Want to help improve it? Constructive criticism is very welcome - especially if you can suggest a better rewording!

Please leave you feedback here in reply to the documentation thread in the Kamaelia blog.

-- Automatic documentation generator, 19 Oct 2008 at 14:29:09 UTC/GMT

This is a page from the Kamaelia website. You can find the original here: