mserv

Mserv - a free open source jukebox-style music server for unix-like systems
mserv.1

MSERV(1)                      Mserv music server                      MSERV(1)



NAME
       mserv - music server

SYNPOSIS
       mserv [-c <config_path>] [-p <port>] [-r <mserv_root>] [-v]

DESCRIPTION
       mserv is a music server for playing mp3s to a group of people via one
       sound device.

       mserv listens on port 4444 and awaits connections from known users
       listed in the acl file.

       The user 'root' is normally special in that it can perform some opera-
       tions, such as renaming tracks, adding other users, etc., that other
       users cannot.

       The manual for users is available via the web on http://www.mserv.org/

OPTIONS
       -v     Verbose mode.  Shows track and album filenames as they are read,
              and also prints all log activity.

       -r <mserv_root_path>
              Specifies where to root mserv's files.  Default is '.mserv' in
              your home directory, and if this directory does not exist it is
              populated automagically.

       -c <config_path>
              Specifies the path to the configuration file to use.  By default
              this is the file 'config' in the mserv root directory (see -r).

       -p <port>
              The port that the server listens on for connections.  Default is
              4444.

MSERVPLAY
       Mserv plays music using the player specified in the config file.  One
       of the players that mserv can use is the 'mservplay' program which is a
       wrapper for mpg123 designed to increase the 'nice' priority. The pro-
       gram must be setuid root, although it is not enabled by default for
       security reasons.  Mservplay is only useful for low-powered processors
       such as pentium 100s or less.

MSERVEDIT
       A perl program that opens up your editor (environment variable EDITOR)
       with a list of all the files in the directory.  This allows you to edit
       the track names/authors/dates without the effort required to do this
       online.  Note that the music server will notice when an on-disk track
       information file is altered and will re-load the information - to force
       this use the 'SYNC' mserv command.  Run this program in the directory
       containing all the '.trk' files (see comments in the mservedit file).

DEFAULT FILES
       ~/.mserv/tracks/
              The directory holding all the music files (e.g. '.mp3's).

       ~/.mserv/trackinfo/
              The directory holding all the track information files ('.trk's
              and 'album' files).

       ~/.mserv/log
              The log file that mserv outputs.

       ~/.mserv/acl
              The access control list.

       ~/.mserv/webacl
              A standard Apache-style password file of colon separated
              <user>:<password> lines where the password is unix crypted.
              This is derived from the acl file.

       ~/.mserv/config
              The configuration file - see comments within.

       ~/.mserv/player.out
              The current track's player output (e.g. from mpg123 indirectly
              from mservplay).

       /usr/local/bin/mservplay
              A wrapper that runs mpg123 at a higher than usual priority
              (nice) value.

       /usr/local/bin/mservedit
              Allows you to edit the track files (see MSERVEDIT section
              above).

AUTHOR
       Written and designed by:
              James Ponder <james@squish.net>

       Contributors:
              Joseph Heenan <joseph@ping.demon.co.uk> who wrote the mp3info
              code to calculate how long a track is and pull out the ID3 tag
              information, and who provided many ideas and testing.

       Thanks to:
              Jonathan Hunt <xlcus@toth.org.uk> for helpful ideas and testing

              Michael Hipp <Michael.Hipp@student.uni-tuebingen.de> for writing
              mpg123 that this program (usually) uses to play tracks

              Monty <xiphmont@mit.edu> for writing cdparanoia (a great ripper)

SEE ALSO
       mservcmd(1), mservcli(3), mpg123(1), cdparanoia(1), bladeenc(1)

WEBSITE
       http://www.mserv.org/



MSERV                            December 1999                        MSERV(1)