This is lxmusserv, a music server for Linux games to play MUS music. It is free
software, available under the GNU Public License; see the file COPYING for 
details.

See the LxDoom site, http://lxdoom.linuxgames.com/, for the latest news 
and releases.

Read INSTALL for installation instructions. Read the man page for command line 
options - unless you've got a fancy setup you want to use, you probably 
won't need to wory though. Normally the musserv is run by the game using it, 
like LxDoom, so if you do want to specify options you'll have to read the 
manual for that game.

MIDI synth setup:
----------------

Since most soundcards have a MIDI uart device (but most people
don't have a MIDI synth connected to them), FM synth is given
preference over gen-midi to avoid sending data to non-existant
devices (and consequent lack of music). Because of this...

*** NOTE *** NOTE *** NOTE *** NOTE *** NOTE *** NOTE *** NOTE ***
If you have a midi synth device and your card does FM-synth also, you
must give them -m option and the -u [device #] option to musserv to
hear the music though your midi synthesizer.  Otherwise you'll get
just FM-output.
*** NOTE *** NOTE *** NOTE *** NOTE *** NOTE *** NOTE *** NOTE ***

Dumping of MUS files / standalone operation
-------------------------------------------

Lxmusserv supports standalone playing of MUS files, if you don't have
a MUS-file extractor, the following crude method will get them for
you.  Pass the -D option to musserv to cause it to dump all songs sent
by lxdoom to different files.  You also need write access to the
directory where lxmusserv is run.  The files will be named
"songXX.mus", where XX is a number 0-99, starting at zero.  Another
file called raw_midi.patch will also be created, you'll need this to
play through FM-cards.  To play a song give the song name as
argument to lxmusserv. If you're using FM-syth also give the FM-patch
file above as a second argument, ie.

$ musserv song01.mus raw_midi.patch


Problems/Troubleshooting:
------------------------

	Musserv relies on the OSS drivers, before reporting bugs
please make sure that your drivers are either compiled in the kernel
or the required modules loaded, AND WORKING properly.  If you're
autoloading your modules make sure you're setup is correct.  Bugs in
the sound drivers should be reported to their respective maintainers.

For bugs or problems with lxmusserv itself, see the LxDoom 
bug tracking system and "sound and music" forum, at 
http://sourceforge.net/project/?group_id=3586. Also see 
http://www.ececs.uc.edu/~rreilova/software/, but this hasn't been updated 
in a while and I haven't been able to contect Rafael.

The original README file that came with musserver is in README.orig,
it covers hardware requirements and other considerations, although is
now somewhat dated.

