icecream (1)

icecream [\s-1OPTIONS\s0] \s-1URL\s0 [\s-1URL\s0..]

icecream is a lightweight, non-interactive, stream download utility. It connects to icecast and shoutcast servers or direct stream URLs, and redirects all fetched content to stdout and/or to media files on your disk.

Listen to the stream piping the output to a stdin-capable media player. Save the stream to a named file or split it into different tracks. It is possible to redirect the stream and save it to disk at the same time.

icecream is able to parse pls and m3u playlists, and to download mp3 and ogg direct stream URLs. If the stream is anonymous it will be saved as 'stream-time.mp3', where time is actual timestamp.

-h, --help

Print a help message describing all options

-q, --quiet

Turn off output

-v, --verbose

Be verbose

-t, --tracks

Split stream into tracks (if possible)

--name=NAME

Save the stream to file specified by \s-1NAME\s0. Format codes starting with \*(L"%\*(R" will be replaced. See the date command for valid format codes.

--stop=N[units]

Stop downloading the stream after N kb/mb/min/songs

--user-agent=AGENT

Set user-agent header to \s-1AGENT\s0

--stdout

Output stream to stdout (implies -q)

--sync

Turn syncing on, required for some mpeg players that read from stdin

--debug

Turn on debugging outputs

Streaming to mpg123

icecream --stdout http://radio.com/playlist.pls | mpg123 -

Split stream into different tracks

icecream -t http://metal.org/radio.pls

Split stream into tracks and play with vlc at the same time

icecream -t --stdout http://streaming.com/playlist.pls | vlc file:/dev/stdin

Prepare a 74 minute \s-1CD\s0

icecream -t --stop 74min http://trace.net/playlist.m3u

Use a filename with today's date as output

icecream -q --name 'radio_%Y_%m_%d' --stop 60min http://radio.com/playlist.pls

You are welcome to send bug reports about icecream to our mailing list. Feel free to visit http://icecream.sourceforge.net

Written by Gil Megidish <gil at megidish.net>