DragonFly On-Line Manual Pages

ginifeed(1)                                                        ginifeed(1)

NAME
       GINIfeed - feed or relay audio and video streams to a GINI server

SYNOPSIS
       ginifeed [options]

DESCRIPTION
       GINIfeed feeds or relays Ogg Vorbis, MP3, RIFF AVI, QuickTime, ASF/WMV
       and RealMedia format streams to a GINI server or an Icecast server
       (video streaming is not supported by Icecast) from files or other
       compatible streams.

OPTIONS
       GINIfeed accepts the following options.

       -H | --host <host>
              The IPv4 address or hostname of the server where GINIfeed should
              connect to. Default is 127.0.0.1.

       -P | --port <port_no>
              Sets the port where GINIfeed will connect to feed the stream.
              Default is 8000.

       -p | --playlist <file>
              Specify the playlist file or stream url GINIfeed. should use.
              For stream relaying use full urls like
              http://host:port/streamname.  The port portion is optional, the
              default is 8000.  See also PLAYLIST TRICKS.

       -r | --random
              Play the files in random order. See also PLAYLIST TRICKS.

       -d | --basedir <directory>
              Treat this directory as the base of the files in playlist.
              Unusable with stream relaying. See also PLAYLIST TRICKS.

       -s | --suffix <file_suffix>
              Put this suffix after every filename found in the playlist.
              Unusable with stream relaying. See also PLAYLIST TRICKS.

       -b | --bitrate <kbps>
              Force GINIfeed to force useing this bitrate when feeding. If you
              not specify this GINIfeed will autodetect it from the files.
              Unusable with stream relaying.

       -n | --name <stream_name>
              Sets the name of the stream. Ignore it if you want to use the
              information of the source server in case of stream relaying.

       -g | --genre <stream_genre>
              Sets the genre of the stream. Ignore it if you want to use the
              information of the source server in case of stream relaying.

       -u | --url <stream_url>
              Sets the http url of the stream. Ignore it if you want to use
              the information of the source server in case of stream relaying.

       -D | --description <stream_desc>
              Sets the description of the stream. Ignore it if you want to use
              the information of the source server in case of stream relaying.

       -m | --mount <mountpoint>
              Use this mountpoint for the stream. This mountpoint will be the
              end of the URL belonging to this stream, for example if you are
              feeding to somehost:someport with a mountname something.ogg then
              the URL of your stream will be
              http://somehost:someport/something.ogg.  IMPORTANT: if you are
              feeding Ogg Vorbis add a .ogg suffix to your mount name, most of
              the audio players have trouble with the stream without this.

       -w | --password <pass>
              Send this password to server.

       -S | --seed <number>
              Sets the random seed for random playback. Unusable with stream
              relaying.  See also PLAYLIST TRICKS.

       -c | --use-cue
              Generate cue file for "now playing" functions. Unusable with
              stream relaying.

       -t | --title-streaming
              Feed file titles to the server too. Unusable with stream
              relaying.

       -G | --use-tag
              Use file tags (if any) as feeded title. Unusable with stream
              relaying.

       -W | --without-dir
              Use filename without directory suffix as feeded title. Unusable
              with stream relaying.

       -z | --background
              Run ginifeed as a daemon in the background.

       -v | --version
              Show version and exit.

       -h | --help
              Show usage and options, and exit.

SIGNALS
       If GINIfeed receives a SIGHUP signal it rereads the specified playlist
       file. Use this if the playlist is changed but you don't want to
       interrupt GINIfeed.  Upon receiving a SIGINT signal GINIfeed
       immediately skips to the next track in the playlist. Receiving two
       SIGINTS in one second will cause GINIfeed to stop feeding and exit.

PLAYLIST TRICKS
       If you want to feed multiple streams (for example the same songs in
       different quality and/or in different format) you should easily do it
       with only one playlist by using the advanced playlist options.

       Directory prefix: If you have files in the same format but in different
       bitrates and you have all of these files in separate directories but in
       the same hierarchy under the toplevel directory you should delete the
       leading directory part from the playlist and specify it as a base
       directory parameter. This way GINIfeed will handle the directory
       differences and you will be able to feed your files using separate
       instances of GINIfeed.

       File suffix: The same applies to different format files, if only the
       file suffix (.ogg, .mp3, etc) is different you should specify it as a
       parameter for separate GINIfeed instances. Don't forget to delete the
       necessary filename suffix from the playlist.

       Random seed: If you're feeding the same files in different formats or
       bitrates and you want to play them randomly, but in the same order for
       every feed then you should do it by using the seed parameter of
       GINIfeed.

DIAGNOSTICS
       This software is in active development, if you find a bug please report
       it at http://sourceforge.net/projects/gini/

AUTHOR
       Krisztian Pifko <monsta@users.sourceforge.net>

SEE ALSO
       gini(8), ginicon(1)

COPYING
       This program is distributed under the GNU Public License.

Version 0.5.1                  January 24, 2003                    ginifeed(1)