ginifeed(1)ginifeed(1)NAME
GINIfeed - feed or relay audio and video streams to a GINI server
SYNOPSISginifeed [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 com‐
patible 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/stream‐
name. 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. Unus‐
able 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/some‐
thing.ogg. IMPORTANT: if you are feeding Ogg Vorbis add a .ogg
suffix to your mount name, most of the audio players have trou‐
ble 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 relay‐
ing.
-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 inter‐
rupt 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 dif‐
ferences 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 ALSOgini(8), ginicon(1)COPYING
This program is distributed under the GNU Public License.
Version 0.5.1 January 24, 2003 ginifeed(1)
