oggfwd(1) [debian man page]
OGGFWD(1) BSD General Commands Manual OGGFWD(1) NAME
oggfwd -- pipe an Ogg stream from stdin to an Icecast server SYNOPSIS
oggfwd [-hp] [-d description] [-g genre] [-n name] [-u URL] address port password mountpoint DESCRIPTION
The oggfwd utility acts as a minimal source client for Icecast servers. It reads an Ogg stream from stdin and forwards it to a server speci- fied on the command line. The address, port, password and mountpoint arguments are mandatory and have to be given in that order. Optional command line parameters -d description Set the stream description. -g genre Set the stream genre. -h Print a short usage summay. -n name Set the stream (i.e. radio) name. -p Allow the stream to be made public in stream directories. -u URL Set the stream URL. oggfwd reacts to the hangup signal, SIGHUP, by printing the amount of bytes read from stdin to stdout at the next given opportunity. How fast it reacts depends on the stream's current bitrate. EXAMPLES
To forward a public Ogg stream with the name ``Test radio'' to an Icecast server, one would pipe that stream to an oggfwd command line such as oggfwd -p -n "Test radio" radio.example.com 8000 password /stream.ogg Encode an Ogg Vorbis stream, dump it to disk and stream it at the same time: oggenc - < input.wav | tee streamdump.ogg | oggfwd radio.example.com 8000 password /stream.ogg AUTHORS
Programming by J^ <j@v2v.cc> rafael2k <rafael@riseup.net> Moritz Grimm <gtgbr@gmx.net> This manual was contributed by Moritz Grimm. CAVEATS
Since the password to the Icecast server is given in clear text on the command line, other (local) users will probably be able to see it very easily. BSD
July 30, 2006 BSD
Check Out this Related Man Page
ICECREAM(1) icecream ICECREAM(1) NAME
icecream - download icecast and shoutcast streams, redirecting all fetched content to stdout and/or to disk at the same time SYNOPSIS
icecream [OPTIONS] URL [URL..] 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. 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. OPTIONS
-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 NAME. Format codes starting with "%" 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 AGENT --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 EXAMPLES
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 CD 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 BUGS
You are welcome to send bug reports about icecream to our mailing list. Feel free to visit http://icecream.sourceforge.net AUTHOR
Written by Gil Megidish <gil at megidish.net> 1.3 2008-04-28 ICECREAM(1)