====================================================================
      MusE  ---  Linux (Midi) Music Editor
====================================================================

Welcome to MusE, the open source MIDI/Audio sequencer.

MusE is distributed under the GNU General Public License (GPL).
Please check out the file COPYING in this directory for more
details.

,-----------------------------------------------------------------.
| NOTICE                                                          |
|-----------------------------------------------------------------|
| Many parts of MusE code are EXPERIMENTAL, and may well result   |
| in a CRASH, and who knows what other ill effects.               |
| RUN THIS SOFTWARE AT YOUR OWN RISK.                             |
`-----------------------------------------------------------------'

  =============================
      Requirements
  =============================

      - QT: Qt 3.1.0 or above ( 3.1.2 recommended )
        ftp://ftp.trolltech.com/qt/source
        MusE does _not_ compile with older versions
        Please compile Qt3 with "-thread" option so you get
        the qt-mt.so lib instead of qt.so
        MAKE SURE YOU SET YOUR 'QTDIR' ENVIRONMENT VARIABLE

      - ALSA 0.9.x or newer (cvs)
        http://www.alsa-project.org/

      - gcc 3.x.x (2.95.3 may work; untested with other versions)
    	    Problems are reported with (unofficial) 2.96, so if you're 
          using it you may be unable to run MusE.
          NOTE: you _must_ compile MusE with the same compiler
                you used to compile QT

      - libsndfile 1.0.1 (current 1.0.4)
        http://www.zip.com.au/~erikd/libsndfile/

      - Linux kernel with rtc (RealTimeClock) driver (device /dev/rtc)
       (you may also apply "low latency patches" for low timing jitter)

      - JACK
        http://jackit.sourceforge.net/
        download:
        http://prdownloads.sourceforge.net/jackit/jack-audio-connection-kit-0.34.0.tar.gz

      - fluidsynth-1.0.0 (formerly iiwusynth) from
        http://savannah.nongnu.org/download/fluid

      - glibc 2.2.x  (untested with other versions)
      - of course: some midi gear
      - (if you compile from cvs:) automake 1.7 and autoconf 2.54

  =============================
      Compiling:
  =============================

      - download source from http://muse.seh.de/download.php
      - uncompress source:
            bunzip2 muse-x.x.x.tar.bz2
      - untar source:
            tar xvof muse-x.x.x.tar </code>
      or if you have a recent tar, you can combine both steps:
            tar xvofj muse-x.x.x.tar.bz2

      - run "qtconfig", open the tab "Library Path" and add the path of
        your installed MusE Sources to the path list;
        This is necessary for the Qt gui compiler "uic" to find the
        MusE specific widget plugins. Without you will get compilation
        errors.

      - enter dirctory muse-x.x.x:
            MAKE SURE YOU SET YOUR 'QTDIR' ENVIRONMENT VARIABLE
            run configure
            run make all

      - test the executable:
        run
            muse demos/rasen.med

      - as root run:
            make install
        to install MusE

  =============================
      some known bugs
  =============================

      - many

====================================================================
Let me know whether MusE works for you !!!  The address of the
MusE mailing list is muse@seh.de.  Have a look at the
webpage http://muse.seh.de/ for details.

