1
.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3
4
.\" ========================================================================
5
.de Sh \" Subsection heading
13
.de Sp \" Vertical space (when we can't use .PP)
17
.de Vb \" Begin verbatim text
22
.de Ve \" End verbatim text
26
.\" Set up some character translations and predefined strings. \*(-- will
27
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28
.\" double quote, and \*(R" will give a right double quote. | will give a
29
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
30
.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
31
.\" expand to `' in nroff, nothing in troff, for use with C<>.
33
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
37
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
38
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
51
.\" If the F register is turned on, we'll generate index entries on stderr for
52
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
53
.\" entries marked with X<> in POD. Of course, you'll have to process the
54
.\" output yourself in some meaningful fashion.
57
. tm Index:\\$1\t\\n%\t"\\$2"
63
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
64
.\" way too many mistakes in technical documents.
68
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
69
.\" Fear. Run. Save yourself. No user-serviceable parts.
70
. \" fudge factors for nroff and troff
79
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
85
. \" simple accents for nroff and troff
95
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
96
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
97
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
98
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
99
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
100
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
102
. \" troff and (daisy-wheel) nroff accents
103
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
104
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
105
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
106
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
107
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
108
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
109
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
110
.ds ae a\h'-(\w'a'u*4/10)'e
111
.ds Ae A\h'-(\w'A'u*4/10)'E
112
. \" corrections for vroff
113
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
114
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
115
. \" for low resolution devices (crt and lpr)
116
.if \n(.H>23 .if \n(.V>19 \
129
.\" ========================================================================
131
.IX Title "ICECREAM 1"
132
.TH ICECREAM 1 "2006-01-17" "1.2" "User Contributed Perl Documentation"
134
icecream \- listen to, or download icecast streams
136
.IX Header "SYNOPSIS"
137
icecream [\s-1OPTIONS\s0] \s-1URL\s0 [\s-1URL\s0..]
139
.IX Header "DESCRIPTION"
140
icecream is a non-interactive stream download utility. It connects
141
to icecast and shoutcast servers and redirects all fetched content
142
to an stdin-capable player or to media files on your disk. With an
143
option turned on, it can save the stream into different files, each
144
representing the played track. It is also possible to tee the input
145
to both disk and stdout.
148
.IP "\fB\-h\fR, \fB\-\-help\fR" 8
149
.IX Item "-h, --help"
150
Print a help message describing all options
151
.IP "\fB\-q\fR, \fB\-\-quiet\fR" 8
152
.IX Item "-q, --quiet"
154
.IP "\fB\-v\fR, \fB\-\-verbose\fR" 8
155
.IX Item "-v, --verbose"
157
.IP "\fB\-\-stdout\fR" 8
159
Output stream to stdout (implies \-q)
160
.IP "\fB\-t\fR, \fB\-\-tracks\fR" 8
161
.IX Item "-t, --tracks"
162
Split stream into tracks (if possible)
163
.IP "\fB\-\-name=NAME\fR" 8
164
.IX Item "--name=NAME"
165
Output stream to file specified by \s-1NAME\s0. Format codes starting
166
with \*(L"%\*(R" will be replaced. See the date command for valid
168
.IP "\fB\-\-stop=N[units]\fR" 8
169
.IX Item "--stop=N[units]"
170
Stop stream after N minutes, song or \s-1KB/MB\s0 transferred
171
.IP "\fB\-\-debug\fR" 8
173
Turn on debugging outputs
174
.IP "\fB\-\-useragent=AGENT\fR" 8
175
.IX Item "--useragent=AGENT"
176
Set useragent header to \s-1AGENT\s0
177
.IP "\fB\-\-sync\fR" 8
179
Turn syncing on, required for some mpeg players that read from stdin
181
.IX Header "EXAMPLES"
182
.IP "Streaming to mpg123" 8
183
.IX Item "Streaming to mpg123"
184
icecream \-s http://radio.com/playlist.pls | mpg123 \-
185
.IP "Split stream into different tracks" 8
186
.IX Item "Split stream into different tracks"
187
icecream \-t http://metal.org/radio.pls
188
.IP "Prepare a 74 minute \s-1CD\s0" 8
189
.IX Item "Prepare a 74 minute CD"
190
icecream \-t \-\-stop 74min http://trace.net/playlist.m3u
191
.IP "Use a filename with today's date as output" 8
192
.IX Item "Use a filename with today's date as output"
193
icecream \-q \-\-name 'radio_%Y_%m_%d' \-\-stop 60min
194
http://radio.com/playlist.pls
197
You are welcome to send bug reports about icecream to our mailing
198
list. Feel free to visit http://icecream.sourceforge.net
201
Written by Gil Megidish <gil at megidish.net>