pcm6shout.conf - configuration file for pcm6shout(1)
The configuration file is the only way to pass options and settings to pcm6shout(1). This man page describes all the available options and where applicable, their default values. The configuration file maybe be located anywhere on the file system and the filename does not need to be pcm6shout.conf.
The format of the pcm6shout configuration file is very simple. There is one configuration option per line in the file. Each option is formatted as option's name, followed by a space, followed by the option's value.
Blank lines and lines beginning with a hash (#) are ignored. The maximum length of a single line is 255 characters. Each configuration option should only appear once.
The address of the IPv6 multicast group to receive packets on. There is no default value for this option.
The port to receive packets on. Should be an even number. RTCP reports are sent on one port higher. Port numbers above 1024 are usually used. There is no default value for this option.
The TTL for RTCP report packets. Default value is 127.
The time in seconds to wait for a packet. Set to 0 to disable timeouts. Default is to wait 10 seconds.
Only accept packets from this SSRC, expressed as a hexadecimal number. Default is to accept packets from the SSRC of the first packet received.
Either "MP3" or "Vorbis". Chooses the format that the audio is encoded to. Default format is MP3.
The bitrate of the encoded MP3 in kbps. Default bitrate is 128. See lame --longhelp for a list of valid bitrates.
Either "Mono", "Joint" or "Stereo". Joint will encode the difference between the two channels, which will result in better quality audio if the two channels are similar. Default mode is Joint.
True quality is determined by the bitrate but this variable will effect quality by selecting expensive or cheap algorithms. Quality is an integer between 0 and 9. Default quality is 3.
0 best quality, very slow
2 near-best quality, not too slow
5 good quality, fast
7 ok quality, really fast
9 worst quality, very fast
The quality of the Ogg Vorbis stream is chosen using a floating point number between 0 and 10.
0.0 is lowest quality, least bandwidth.
4.0 is default (about 128 kbps VBR).
10.0 is highest quality, most bandwidth.
True or False. Downmix a stereo source stream to mono before encoding to Ogg Vorbis. Default is to not downmix.
The IP address or hostname of the Icecast/Shoutcast server to connect to. Default host is localhost.
The port of the Icecast/Shoutcast server. Default is port 8000.
The protocol to use for communicating with the server. Use "http" for an Icecast 2 Server, "shoutcast" for a Shoutcast server, or "audiocast" for an Icecast 1 Server. Default protocol is http.
The source password for connecting to the server. There is no default password.
Optional username for the server. Default username is "source".
True or False. Should this stream be advertised on public directories ? Default is not to be public.
The name of the stream. Default is "Unconfigured pcm6shout stream".
The audio genre of the stream. Default is no genre.
A URL for users to find out more information about the stream. Default is no URL.
A textual description about the content of the stream. Default is no description.
Mountpoint for Icecast servers. This allows you to server more than one audio stream with a streaming server. For example "/stream_low.ogg". Default is to use the default mount (/).
The filename for archives of the stream to be recorded remotely on the server. Default is not to have a dump file.
Written by Nicholas J Humfrey, <njh@ecs.soton.ac.uk>
Main web site: http://www.ecs.soton.ac.uk/~njh/pcm6cast/
pcm6shout(1), pcm6client(1), pcm6cast(1)
Copyright © 2003,2004 University of Southampton. Free use of this software is granted under the terms of the GNU Lesser General Public License (LGPL)
Version 0.1
Last updated 19-May-2004 10:57:49 BST