.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "ICECREAM 1"
.TH ICECREAM 1 "2008-04-28" "1.3" "icecream"
.SH "NAME"
icecream \- download icecast and shoutcast streams, redirecting all fetched
content to stdout and/or to disk at the same time
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
icecream [\s-1OPTIONS\s0] \s-1URL\s0 [\s-1URL\s0..]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
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. 
.PP
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.
.PP
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.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-h\fR, \fB\-\-help\fR" 8
.IX Item "-h, --help"
Print a help message describing all options
.IP "\fB\-q\fR, \fB\-\-quiet\fR" 8
.IX Item "-q, --quiet"
Turn off output
.IP "\fB\-v\fR, \fB\-\-verbose\fR" 8
.IX Item "-v, --verbose"
Be verbose
.IP "\fB\-t\fR, \fB\-\-tracks\fR" 8
.IX Item "-t, --tracks"
Split stream into tracks (if possible)
.IP "\fB\-\-name=NAME\fR" 8
.IX Item "--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.
.IP "\fB\-\-stop=N[units]\fR" 8
.IX Item "--stop=N[units]"
Stop downloading the stream after N kb/mb/min/songs
.IP "\fB\-\-user\-agent=AGENT\fR" 8
.IX Item "--user-agent=AGENT"
Set user-agent header to \s-1AGENT\s0
.IP "\fB\-\-stdout\fR" 8
.IX Item "--stdout"
Output stream to stdout (implies \-q)
.IP "\fB\-\-sync\fR" 8
.IX Item "--sync"
Turn syncing on, required for some mpeg players that read from stdin
.IP "\fB\-\-debug\fR" 8
.IX Item "--debug"
Turn on debugging outputs
.SH "EXAMPLES"
.IX Header "EXAMPLES"
.IP "Streaming to mpg123" 8
.IX Item "Streaming to mpg123"
icecream \-\-stdout http://radio.com/playlist.pls | mpg123 \-
.IP "Split stream into different tracks" 8
.IX Item "Split stream into different tracks"
icecream \-t http://metal.org/radio.pls
.IP "Split stream into tracks and play with vlc at the same time" 8
.IX Item "Split stream into tracks and play with vlc at the same time"
icecream \-t \-\-stdout http://streaming.com/playlist.pls | vlc file:/dev/stdin
.IP "Prepare a 74 minute \s-1CD\s0" 8
.IX Item "Prepare a 74 minute CD"
icecream \-t \-\-stop 74min http://trace.net/playlist.m3u 
.IP "Use a filename with today's date as output" 8
.IX Item "Use a filename with today's date as output"
icecream \-q \-\-name 'radio_%Y_%m_%d' \-\-stop 60min http://radio.com/playlist.pls
.SH "BUGS"
.IX Header "BUGS"
You are welcome to send bug reports about icecream to our mailing list.
Feel free to visit http://icecream.sourceforge.net
.SH "AUTHOR"
.IX Header "AUTHOR"
Written by Gil Megidish <gil at megidish.net>