shout - feed an mp3 stream to an icecast server

shout [options]

shout feeds an mp3 stream to either an icecast server (free) or a shoutcast server (proprietary, developed by Nullsoft). The stream can be played back using listen(1).

shout takes the following options:

-B

This option is obsolete. You must now keep playlists, pid files, and .conf files within the etc directory located under the current working directory when shout is launched.

-C file

Use file as a configuration file. Options prior to this on the command line are overridden. Options after this override whatever this configuration file specifies. If the file doesn't exist, shout exits. The default file is shout.conf located in the cwd/etc/ directory. This file includes most configuration options as of this writing. It is suggested that this is used for most options, only overriding them on the command line when necessary for scripting reasons or whatnot.

-D file

If not overridden, shout will run file with a system() call before every song. This option implies the -d option.

-P password

Use password when connecting to server.

-S

Display all compile-time settings, default settings, and current settings, and exit.

-V

Turn verbose mode on.

-b bitrate

This is hardly used any more. But if autodetection of bitrate is off, then this value gets used as the transfer bitrate.

-d

Activate the dj. This turns the use of the dj program on.

-e port

Make shout connect to this port. The default is 8000.

-f

Force. Skip all the files that have a bitrate other than the specified default. (Changing bitrate will make the player puke.)

-g genre

Send this as the icy-genre to the server.

-h

Show usage and options, and exit.

-k

Don't truncate the internal playlist when starting the program. (Pick up where we left off.)

-l

Loop forever. When we get to the end of the playlist, shuffle it (if shuffle is on), and start over from the top.

-n name

Use name as icy-name when connecting to the server.

-o

Turn off the bitrate autodetection.

-p file

Append file to the internal playlist. This option can be repeated many times.

-r

Shuffle playlist (at first, and every time we loop).

-s

Set the icy-public flag to 0. (Don't send metadata to the directory server.)

-t

Turn on titlestreaming to the icecast/shoutcast server.

-F

Remove directory information when using file names for title streaming.

-u url

Use url as icy-url when connecting to the server.

-v

Show version and exit.

-x

Don't update the cuefile when streaming.

-z

Launch shout in the background.

shout always looks for the configuration file specified as the default in shout.h. shout will parse the config file if it finds one. If you specify another config file with the -C file option, it parses that too. See README.shout for more details on the configuration file format.

This manual page was written by Colin Watson <cjwatson@debian.org>, based on the shout documentation by the authors of icecast.

listen(1).