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.