      Welcome to KSynth, a realtime sound synthesis software for Unix!
      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. What you need to compile:

   Currently it is only tested to compile and run with the following
   software (higher versions are allowed ;) installed on your computer:

    - Linux 2.0.30                  http://www.linux.org
    - Qt 1.32                       http://www.troll.no
    - KDE beta 4                    http://www.kde.org
    - mico 2.0.7                    http://diamant.vsb.cs.uni-frankfurt.de/~mico
    - egcs 1.0.2                    http://egcs.cygnus.com

   I suppose you should be able to use the software if you have gcc-2.7.x
   or gcc-2.8.x as well, but it is possible that you have to tune the
   configure stuff a little. (Report me, if you don't get it installed
   what goes wrong, I should be able to help you).

   For other operating systems you need to provide another sound driver.
   Usually it should be possible to take the corresponding source from
   mpeg3play version 0.9.6 (the sound support of the synthesizer is based
   on their routines, see README.sound for details) and add realtime
   capabilities.  
   This has only been done for linux so far.

2. How to compile & install:

   Just type

     ./configure
     make
     make install

   Currently, this builds the stuff including the KDE gui. It is no
   problem to include support for other GUIs as well, the design is clear
   enough (and the CORBA stuff is in there). But since there is no
   other GUI yet...

3. Running the stuff

   The synthesizer requires realtime priority to work nice. Since only root
   is able to give it to the synthesizer do the following:

   Open a terminal windows on your X screen, become root (type su and
   enter your root password).

   Run the synth_server script, which will start synth_server.bin with
   the appropriate parameters to be used from the gui.

   Now you can start your favourite gui (hint: there is only ksbuild at this
   time). Under KDE, the application should appear under the multimedia
   section of your K-menu (KSynth Builder). If it's not there yet, you can
   try to restart your panel.

   And now, you should be able to play with it.

4. If you'd like to find out more about what this project will be about,
   read README.corba.

Have fun...

   Stefan <stefan@space.twc.de>
