oggfwd — pipe an Ogg stream from stdin to an Icecast server

       Programming by
             J^ <j@v2v.cc>
             rafael2k <rafael@riseup.net>
             Moritz Grimm <gtgbr@gmx.net>

       This manual was contributed by Moritz Grimmi and updated by Philipp Schafft.

       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.

Debian                                           April 12, 2015                                        OGGFWD(1)

       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 specified on the command line.

       The address, port, password and mountpoint arguments are mandatory and have to be given in that order.

   Optionalcommandlineparameters-mmetadatafile
               Sets a file holding stream meta data.

       -ddescription
               Set the stream description.

       -ggenre
               Set the stream genre.

       -h      Print a short usage summay.

       -nname
               Set the stream (i.e. radio) name.

       -p      Allow the stream to be made public in stream directories.

       -uURL  Set the stream URL.

       -TTLSmode
               This sets the TLS (encryption) mode. Valid values are "disabled"  (no  encryption),  "auto"  (any
               encryption  if  available),  "auto_no_plain"  (any  encryption),  "rfc2818"  (encryption based on
               RFC2818) and "rfc2817" (encryption based on RFC2817). For most  users  the  default  mode  "auto"
               should work just fine.

       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.

       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

       oggfwd — pipe an Ogg stream from stdin to an Icecast server

oggfwd [-hp] [-mmetadatafile] [-ddescription] [-ggenre] [-nname] [-uURL] [-TTLSmode] addressportpasswordmountpoint