~ubuntu-branches/ubuntu/oneiric/muse/oneiric

« back to all changes in this revision

Viewing changes to README

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Kobras
  • Date: 2002-04-23 17:28:23 UTC
  • Revision ID: james.westby@ubuntu.com-20020423172823-w8yplzr81a759xa3
Tags: upstream-0.5.2
Import upstream version 0.5.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
====================================================================
 
2
      MusE  ---  Linux (Midi) Music Editor
 
3
====================================================================
 
4
 
 
5
Welcome to MusE, the open source MIDI/Audio sequencer.
 
6
 
 
7
MusE is distributed under the GNU General Public License (GPL).
 
8
Please check out the file COPYING in this directory for more
 
9
details.
 
10
 
 
11
,-----------------------------------------------------------------.
 
12
| NOTICE                                                          |
 
13
|-----------------------------------------------------------------|
 
14
| Many parts of MusE code are EXPERIMENTAL, and may well result   |
 
15
| in a CRASH, and who knows what other ill effects.               |
 
16
| RUN THIS SOFTWARE AT YOUR OWN RISK.                             |
 
17
`-----------------------------------------------------------------'
 
18
 
 
19
  =============================
 
20
      Requirements
 
21
  =============================
 
22
 
 
23
      - Qt: Qt 3.0.0 or above ( 3.0.1 recommended )
 
24
        ftp://ftp.trolltech.com/qt/source
 
25
        MusE does _not_ compile with older versions
 
26
        Please compile Qt3 with "-thread" option so you get
 
27
        the qt-mt.so lib instead of qt.so
 
28
      - gcc 2.95.3 (untested with other versions)
 
29
            Problems are reported with 2.96, so if you're using it
 
30
            you may be unable to run MusE.
 
31
      - glibc 2.2.x  (untested with other versions)
 
32
      - Linux kernel with rtc (RealTimeClock) driver (device /dev/rtc)
 
33
       (apply "low latency patches" for low timing jitter)
 
34
      - ALSA from http://www.alsa-project.org/
 
35
        checked version 0.9.x 0.6x
 
36
        also checked ALSA OSS-Emulation
 
37
      - of course: some midi gear
 
38
      - (for cvs code) automake 1.5 and autoconf 2.52
 
39
 
 
40
  =============================
 
41
      Compiling:
 
42
  =============================
 
43
 
 
44
      - download source from http://muse.seh.de/muse-current-tar.bz2
 
45
      - uncompress source:
 
46
            bunzip2 muse-current-tar.bz2
 
47
      - untar source:
 
48
            tar xvof muse-current-tar </code>
 
49
 
 
50
      - enter dirctory muse-x.x.x and edit make.inc:
 
51
            + Make sure that QTDIR points to the directory
 
52
              you installed your qt-libraries and header-files
 
53
 
 
54
      - run "qtconfig", open the tab "Library Path" and add the path of
 
55
        your installed MusE Sources to the path list;
 
56
        This is necessary for the Qt gui compiler "uic" to find the
 
57
        MusE specific widget plugins. Without you will get compilation
 
58
        errors.
 
59
 
 
60
      - run
 
61
            make depend (optional if you don�t want to modify the source)
 
62
            (ignore any errors)
 
63
      - run
 
64
            make
 
65
            (if you installed a root password, make will ask you
 
66
            that password in order to set MusE SUID root)
 
67
            Note: The executable is suid root to get access to the
 
68
                  /dev/rtc device. It is _not_ sufficient to set
 
69
                  access rights of /dev/rtc to 0666. Only root can
 
70
                  set the necessary hight interrupt rates.
 
71
                  Without the real time clock timing will be bad.
 
72
                  For best timing you also have
 
73
                  to set the -R option to start the sequencer
 
74
                  thread with realtime priority.
 
75
 
 
76
            Some people reported "undefined symbol errors" due to
 
77
            missing header files. This depends on your system
 
78
            environment. Please report!
 
79
 
 
80
      - test the executable:
 
81
        run
 
82
            muse demos/rasen.med
 
83
 
 
84
      - as root run:
 
85
            make install
 
86
        to install MusE
 
87
 
 
88
  =============================
 
89
      some known bugs
 
90
  =============================
 
91
 
 
92
      Underrun Errors
 
93
      Configure your audio device for "play", not for "record" or
 
94
      "duplex". Recording is currently not full supported.
 
95
      Next set "delay" or "framesize" of your audio device to some
 
96
      sane value. A small framesize requires running MusE with
 
97
      realtime scheduling turned on ("-R" option). Very small
 
98
      values require kernel "low latency patches". This is
 
99
      only useful if you want to play the sw synthesizer in
 
100
      realtime.
 
101
 
 
102
====================================================================
 
103
Let me know whether MusE works for you !!!  The address of the
 
104
MusE mailing list is muse@seh.de.  Have a look at the
 
105
webpage http://muse.seh.de/ for details.
 
106