Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Find out what a Shoutcast station is currently playing.
Ruby
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
test
.gitignore
README.md
Rakefile
shoutcast_status.gemspec

README.md

shoutcast_status

Find out what a Shoutcast station is currently playing.

Usage

sc   = ShoutcastStatus.new("example.com", "punkrock")
info = sc.stream_info
info.artist # => "Sex Pistols"
info.title  # => "Anarchy in the UK"

See the StreamInfo object for more fields.

This assumes that the server exposes a callback API at the usual path, namely:

http://example.com/cast/js.php/punkrock/streaminfo

If this is not the case, an alternative URL can be supplied as the only parameter when initialising ShoutcastStatus; this can be either the tunein.php URL:

sc = ShoutcastStatus.new("http://example.com/somewhere/tunein.php/punkrock/playlist.pls")

or an explicit path to the callback API:

s  = ShoutcastStatus.new("http://example.com/path/to/punkrock/streaminfo")

Dependencies

therubyracer is used to interpret the JavaScript sent by the server.

Something went wrong with that request. Please try again.