 

      dyne.org autoproduzioni & the FreakNet Medialab

                       proudly present:

            __  __       ____  _____    ___   ___  
           |  \/  |_   _/ ___|| ____|  / _ \ / _ \ 
           | |\/| | | | \___ \|  _|   | | | | (_) |
           | |  | | |_| |___) | |___  | |_| |\__, |
           |_|  |_|\__,_|____/|_____|  \___(_) /_/ 
                               codename "COTURNIX"

 this is RASTA SOFTWARE, Jah Rastafari Livity bless your freedom!

             :: the Multiple Streaming Engine ::
                    http://muse.dyne.org

This application is being developed in the hope to provide the Free
Software community a user friendly tool for network audio streaming,
making life easier for indypendent free speech radios wanting to
stream via http on icecast servers.

MuSE is an application for mixing, encoding, and network streaming of
sound: it can transmit an audio signal by mixing together sound taken
from files or also network, recursively remixing more MuSE streams.

MuSE can simultaneously mix up to 6 encoded audio bitstreams (from
files or network, ogg, mp3, wav and other common sound formats), plus
an input signal from microphone.

MuSE offers an intuitive interface to be operated in realtime, while
it can also run slick from the Unix commandline.



***** Supported servers:

You can use MuSE to stream both MP3 or Ogg/Vorbis sound format to a
broadcast server, which means that for doing an online radio you still
need to setup yours, or find one that let you stream.

Such servers can be seen like antennas which amplify your signal and
redistribute it to listeners. there are free software implementations
of such technology! the ones supported by MuSE are:

- Icecast2 - http://icecast.org - can stream OGG & MP3
- Litestream - http://litestream.org - can stream MP3
- Darwin - http://developer.apple.com/darwin/projects/streaming
- Shoutcast - http://shoutcast.com - non free, runs on win32


***** Supported players:

MuSE streams via http, it doesn't uses multicast technology, nor
RTP/RTSP, to have the widest possible range of compatible players.
You can listen audio produced by MuSE from almost every personal
computer and operating system, using one or more of the following:

- xmms - http://www.xmms.org - for GNU/Linux, *BSD, Sun, etc.
- mpg123 - http://www.mpg123.de - for various UNIX systems
- itunes - http://www.apple.com/itunes - on MacOSX
- zinf - http://www.zinf.org - on GNU/Linux and Win32
- winamp - http://www.winamp.com - on all Win platforms

and even more players: something should be also allready available for
handeld devices and embedded systems as well.


***** Internals:

MuSE is written in C++ and is a multithreaded application. It reads
streams using the included libmpeg library (mp3 format) and it can
optionally link the OggVorbis library to read ogg files. For encoding
the sound into mp3 or ogg it can link either or both LAME and
OggVorbis as shared libraries. MuSE also features a user interface
using the GTK+ widget library and a console interface using ncurses.

Resampling of any input is done with bicubic interpolation to 44khz
stereo format, then channels get mixed together and encoded to the
desired quality by the selected codec.

Separate threads are running for each decoder, the mixer and the
encoders, while the flow is synced thru FIFO pipes which implement
mutex locking and avoid well race conditions.

All the functionalities of MuSE are quite well exposed thru a reusable
API, which in fact was the one used to build the GUIs on top.
Documentation for it is available on http://muse.dyne.org/codedoc 

If you are interested, you are very welcome to build new MuSE
interfaces, there are still a lot of unexplored possibilities and this
engine can be a realiable backend for radio automation interfaces and
more. Get in touch with developers! join the mailinglist on
http://lists.dyne.org/muse or peek into irc.freenode.net channel #dyne



***** Libraries:

- LAME (optional)
  Lame can be installed but is no more needed, 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.

- GTK+ (optional)
  if libgtk and all the related libraries are present, MuSE will
  compile the GTK+ graphic user interface for interactive use and
  additional fun.

- NCURSES (optional)
  if libncurses is present, MuSE will compile a text console
  interactive interface to be used into ASCII terminals.

- SNDFILE (optional)
  if libsndfile is present then you'll be able to play uncompressed
  sound files like wav, aiff, snd, voc, pvf, mat, au, sf etc.



***** Compile and install:

- you can get latest version of lame: (if you already have lame and
  libmp3lame jump to point 2, after checking that version is >3.89)
  with 'lame --version'
  or download it from www.mp3dev.org/mp3 and follow the simple
  instructions to get installed this wonderful GPL mp3 encoder.

- install libogg and libvorbis:
  http://www.xiph.org/ogg/vorbis/index.html

if you don't install any of the above, MuSE will be a simple player.

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

you can also make a debian package and debian aided compilation with:
fakeroot debian/rules binary
this command will build debian packages for you!

to KNOW MORE go to the website on http://muse.dyne.org


***** Report bugs

BUG REPORTING is REALLY APPRECIATED! BUT TAKE CARE TO DO IT WELL:
please ALWAYS REPORT the muse --version you are running and possibly
run the binary with gdb giving us the backtrace of the error.

if you understand the above, please go to http://bugs.dyne.org and
submit a BUG!!!




===== AUTHORS

MuSE is copyleft (c) 2000-2004 by Denis "jaromil" Rojo

MuSE's GTK+ GUI is copyleft (c) 2001-2004 by Antonino "nightolo" Radici

MuSE's NCURSES GUI is copyleft (c) 2002-2004 by Luca "rubik" Profico

MuSE's first GUI is copyleft (c) 2000-2001 by August Black

included resampling algos are copyleft (c) 2002 by Matteo "MoP" Nastasi

part of the redistributed code is copyright by the respective authors,
please refer to the AUTHORS file and to the supplied sourcecode for
further information and to COPYING for the full license.

for MuSE's development, the author and mantainer has been supported by
PUBLIC VOICE Lab ........ [ http://www.pvl.at ]
SERVUS.AT ............... [ http://www.servus.at ]




***** PLEASE DONATE!

This whole software was built by autonomous efforts and occasionally
supported by non-profit organizations, while the development currently
relies on the political believing of MuSE's authors, that there should
be such a tool and it should be freely available to people willing to
do online radio.

If you can afford to donate us some money let us know, we also need
new and old working hardware.

The main coder is a nomad and has no fixed job, you can help him
survive with a small donation via paypal.com to jaromil \@\ dyne.org
this would be allready much if most users do! and you can be sure this
way MuSE will keep on existing.

The MuSE development team is also avaliable to run formation courses
about usage, customization and reuse/abuse of free and open source
software - it offers as well support and warranty, development of
software solutions and consulting.

There were a number of workshops allready done around Europe on free
and opensource network radio streaming, by the hackers @ dyne.org
if you want to organize one you're very welcome to contact us!
this way you can also help us develop more free software.

THANKS, a thousand flowers will blossom!





== DISCLAIMER

This source code is free software; you can redistribute it and/or
modify it under the terms of the GNU Public License as published 
by the Free Software Foundation; either version 2 of the License,
or (at your option) any later version.

This source code is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
Please refer to the GNU Public License for more details.

You should have received a copy of the GNU Public License along with
this source code; if not, write to:
Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
