=============================================================
      Short instructions to get the soft
      synthesizer up and running
=============================================================

1. Compile and install MusE

3. Run MusE from an xterm with Option "-D";
   look at the debug output in the xterm; you should see something
   like:

      3 soft synth found
      found soft synth <iiwu> <iiwu soft synth>
      found soft synth <organ> <organ soft synth>
      found soft synth <S1> <organ soft synth>


4. Configure Software Synthesizer

   Open Config->SoftSynthesizer.
   You see two lists:

      - the left list contains all available soft synthesizer
        MusE found
      - on the right you see the (empty) list of synthesizer
        instances

   To use a soft synth, you must first instantiate one from the left list:

      - select organ: click on the "organ" synthesizer
      - press "Add Instance"

   This creates an new alsa device and a Synthi object.
   The new instance is listed on the right list with a unique name ("organ-1").

   If you look at /proc/asound/seq/clients:

      cat /proc/asound/seq/clients

   you find a Client "organ" with a midi port named "organ-1"

   You can use more than one instance of a synthesizer in a song

5. Configure Midi Port

   To use the new available midi device in MusE you must
   assign it to a MusE midi port:

      Configure->MidiPorts

      - choose the port (line) you want to configure and click
        in column DeviceName to get a pulldown list of available
        midi devices

      - select organ-1 from this list

   This assigns the midi device organ-1 to the selected port.
   The instrument type (organ) is automatically set.

6. Audio Port

   Check you have configured a valid audio device

      Configure->AudioSystem

6. Open the Audio Mixer

      You see a new mixer strip titled  "Synthi" and in next line
      "organ-1".

      Route the audio output of this strip to "Master".

7. Now you are ready to play with the "organ" synthesizer

      - create midi track
      - click the "R" column in the tracklist to enable "Recording"

8. Optional: open Configure->MidiPorts and click in column GUI
   to show a GUI for the sythesizer instance.
      There is no gui available for the S1 synth.
      The iiwu gui enables you to enter a different sound font.
      The organ gui has some "draw bars" to let you play with
      sounds in real time.


9. experiment with latency:
      - open Config->AudioSystem
      - change frame size and click OK or Apply


HINT:  If you save your setup with
      Config->saveConfiguration
the current configuration is the default configuration if you
load a midi file next time.

These are the software synthesizers currently available:

      - S1  a simple sythesizer skeleton as a guide for all who
        want to code their own one:
            - only one tone at a time
            - simple sinus wave form
            - no gui

      - organ, an adapted version of the LADSPA plugin
        "Organ - Additive Organ Synthesizer Voice" from
        David A. Bartold

        "organ" implements a gui connected bidirectional
        to the synth via stdin/stdout

      - iiwu, is the adapted version of Peter Hanappe´s
        sample based iiwu synthesizer
            - loadable sound fonts
            - multi timbral
            - 128 voices
            - simple gui lets you load a different sound font

