[[[ MuSE 0.6.1 "vollmundig wuerzig" release ]]]
       :: Multiple Streaming Engine ::

MuSE aims to be an application for the mixing, encoding, and streaming of
sound. MuSE is a server engine that can simultaniously mix up to 6
separate mp3 or oggvorbis audio files from the hard drive where each
channel of audio can be dynamicly adjusted for speed and volume plus a
soundcard line-in channel. The resulting stream can be played locally on
the sound card and/ or encoded as an mp3 data stream to an icecast (or
shoutcast) server.

MuSE is being developed in the hope to provide the GNU community with a
(ab)user friendly tool for network streaming, making life easier for
independent free speech radios.

MuSE is released under the Gnu Public Licence.

***** Internals:

For reading and playing of files MuSE uses the included libmpeg library
for mp3 decoding and the OggVorbis library for ogg decoding. For encoding
the sound into mp3, uses the Lame library thru API calls. It uses libshout
for managing x-audiocast authentication to stream mp3 (icecast-shoutcast
compatible). MusE is written in C++ and is a multi-threaded application.

***** Requirements:

* LAME
Lame needs to be installed, in particular libmp3lame and the header lame.h
must be properly installed.

* OGG VORBIS (optional)
You can compile and install libogg and libvorbis on your
machine before compiling MuSE, the configure script will recognize them
and include support for decoding and mixing of .ogg files.

***** Compile and install:

1.) get lame: (if you already have lame and libmp3lame jump to point 2)
download it from www.mp3dev.org and follow the simple instructions to get
installed this wonderful GPL'ed mp3 encoder.

3.) (optional) install libogg and libvorbis:
    http://www.xiph.org/ogg/vorbis/index.html

4.) next compile:
cd MuSE-x.x.x
./configure
(or try ./configure --help to have listed some compile options)
make

5.) MuSE needs a playlist to function 
make a playlist with:
[ find /pathto/your/illegal/mp3s -name "*.mp3" -print > playlist ]
you can also create and edit it using the xmms playlist editor, perhaps
also your favourite text editor will do the job: each line is the *full
path* to each file (or a url to a http stream).

6.) start MuSE
well, if everything compiled, the executable is then called muse and
should be present into your MuSE-x.x.x build directory. using make install
you can copy it into the configured --prefix, default is /usr/local.

BUG REPORTING is REALLY APPRECIATED
please read KNOWN-BUGS before reporting any bug and then contact the
muse@servus.at mailinglist, THANKS!

***** Hackers:
Take a look into generic.h for tweaking some features, then i'm collecting
some descriptions over source files.

Join the developer mailing list muse@servus.at:
mail majordomo@servus.at with into the body "subscribe muse".

--

MuSE - http://muse.dyne.org
MuSE is (c)2000-2001 by Denis Roio aka jaromil
MuSE GUI is (c)2000-2001 by August Black
to contact mail to <muse-team@dyne.org>

During 2000 MuSE project has been supported by
SERVUS.AT [ http://www.servus.at ]
 they have cool projects and offer good bandwidth!

All the libraries included in MuSE are copyrighted by the respective authors,
please refer to AUTHOR and COPYING files in each subdirectory for further
details.
