GNUMP3d(1)

NAME
GNUMP3d - GNU MP3 Streaming Server

SYNOPSIS

mp3d is a simple server allows you to stream MP3's, and OGG Vorbis files across a network, the operation of this server is controlled by the configuration file mp3d.conf

By default the configuration file lives in /etc/mp3d.conf but the server can be told to use a different file, via the --config argument.

CONFIG FORMAT
  The format of the configuration file is very straightforward, each line is either a comment, (that is a line beginning with '#'), or a line of the format:

key = value

IMPORTANT OPTIONS
  Below is a list of the important options you may specify, and their meaning.

port

  The port upon which the server listens, this may be any port which is not already in use upon your machine. root

  The root directory where we serve content from. This should be the directory containing the MP3, OGG, and media files that you wish to share. user

  If there is a user value setup then the server will become that user, after creating the listening socket.
  If you want to run this server via init.d, (which has the effect of starting the daemon as root), you should make sure you have this set to an appropriate value.

  Otherwise you will have the server running as root, which is clearly not a good idea - even in the unlikely event that this application is 100% bugfree.
  You may comment the line out if you are running the deamon from your home directory, and you are the only user with read access to the server root.
  However for the benefit of fellow computer users is recommended that you run the server as a user such as 'nobody', and allow people read-only access to your audio files. logfile

  The name of the file to write all accesses to. The logfile is written in the Apache common logfile format - so it may be analysed by common tools. maximum_connections

   This gives the maximum number of simulataneous connections which the server will handle. Any additional connections will be served a simple error page - and denied access.

AUTHOR Steve Kemp <skx@tardis.ed.ac.uk>

SEE ALSO
mp3d(1), mp3d-top(1)