Installation

From MusE Wiki

Jump to: navigation, search

Contents

[edit]

How to Obtain MusE

MusE is available here: Download. Download the latest release and follow the installation instructions below.

[edit]

System Requirements

[edit]

Software

To build MusE 0.7 you need:

  • kernel 2.4 with Low Latency patch compiled in manual here
  • OR kernel 2.6 with module "realtime" also called the realtime-lsm module
  • RealTimeClock support (/dev/rtc with CONFIG_RTC in your kernel)
  • ALSA (Advanced Linux Sound Architecture)
    • 0.5.9c (should be working but is not tested with 7.x)
    • 1.x.x is tested and is working
  • Jack - Jack Audio Connection Kit 0.98.1 (older versions won't work!)
    • The "jackd" daemon of course
    • libjack 0.98.1
    • libjack 0.98.1 development files
  • libcap-dev 1.10++ (is working, maybe older versions, too)
[edit]

Hardware

  • CPU: at least 1 GHz
  • Ram: 256 Mb for midi and audio recording (no softsynths)
  • plenty free space on your Harddrive (for audio recording)

There are reports that MusE is running with less but we want to give a general impression what the minimum requirement are.

[edit]

(Other) Supported Platforms

At the moment we support these platforms:

  • x86 IBM computer running Linux.
  • PPC Mac running Linux.

MusE does not run on any Windows or Mac version because it depends on ALSA and the JACK sound system. Not to forget the Linux kernel specific code. Maybe there are other systems like sparc or alpha, MusE could be working with (in case Linux is used). When you're lucky and have Linux working on your exotic hardware there might be a change that you can use MusE with some adaptions. 

If so please report your success to us!

Why MusE will not work together with windows, read on Faq#Is MusE running on Windows.

[edit]

Why Realtime Matters

Having MusE and other applications running with realtime priority is very important because of the resulting quality. If you don't use low latency you will get bad timings on high system loads and this usually happens while recording audio. So having no low latency patch used will result in crackling noise and MIDI timeing problems.

More about latency here: 

http://en.wikipedia.org/wiki/Latency

Hint: To improve your performance try:

  • stay off the network
  • close unnecessary applications
  • do not use KDE / GNOME instead use blackbox
  • turn off your screensaver
  • look at your cron jobs
  • only run MusE and the other necessary apps
  • kernel 2.6.x: install the Realtime-lsm module module
  • kernel 2.4.x: with the preemted patches is reported to have even better timing compared to 2.6.x

These preparations will ensure that MusE receives high priority in the least problematic environment. MusE can be run without attention to these factors, but your stability and security will certainly vary if you choose to ignore these recommendations.

MusE supports this realtime approaches already: Realtime

You might also be interested in this mail i found about the 2.6 preemption patch which moved here [1].

Please note that the --enable-rtcap configuration option is only valid for a patched 2.4 system

[edit]

Installation Of A Binary Package

[edit]

RPM, ReHMuDi, Redhat, SuSE, Mandrake

If you use Mandrake you should try here: 

 http://rpm.nyvalls.se/
 Some instructions is available on the page. (in short, you import the repository and type 'urpmi muse')

If you use Redhat there is an addon repository called Planet CCRMA http://ccrma.stanford.edu/planetccrma/software/, no further instructions currently available, (feel free to add)

[edit]

DEB, Debian, DeMuDi, Knoppix

If you have debian, there is also a package called "muse":

Get root and open a console then type: 

apt-get update

After this type: 

apt-cache search muse

Oh the result looks good: 

muse - Qt-based midi/audio sequencer

Ok we found the package, if not try http://www.apt-get.org and use the search function to find the MusE package. Simply search for muse, if you find a mirror, add the line to you /etc/apt/sources.list and again type: 

apt-get update

Afther this update you should be able to perform the installation with: 

apt-get install muse
[edit]

Compiliation And Installation

[edit]

What you need (my installed debian packetlist):

Here the command (qt specific things):

apt-get install libqt3-headers libqt3-i18n libqt3-mt-dev libqt3c102-mt qt3-assistant qt3-designer qt3-dev-tools qt3-doc qt3-qtconfig automake1.9 pkg-config cpp-3.3 libtool1.4

Here the command (MusE specific things):

apt-get install libjack0.80.0-dev libjack0.80.0-0 libsndfile1-dev libsndfile1 libfluidsynth-dev ladcca-dev

joachim@debian:~/tmp/muse-stuff/muse$ dpkg -l | grep qt3

  • ii libqt3-headers 3.2.3-2 Qt3 header files
  • ii libqt3-i18n 3.2.3-2 i18n files for Qt3 library
  • ii libqt3-mt-dev 3.2.3-2 Qt development files (Threaded)
  • ii libqt3c102-mt 3.2.3-2 Qt GUI Library (Threaded runtime version)
  • ii qt3-assistant 3.2.3-2 The Qt3 assistant application
  • ii qt3-designer 3.2.3-2 Qt3 Designer
  • ii qt3-dev-tools 3.2.3-2 Qt3 development tools
  • ii qt3-doc 3.2.3-2 Qt3 API documentation
  • ii qt3-qtconfig 3.2.3-2 The Qt3 Configuration Application

joachim@debian:~/tmp/muse-stuff/muse$ ### misc stuff ###

  • ii automake1.9 1.9.3-1 A tool for generating GNU Standards-complian
  • ii pkg-config 0.15.0-4 Manage compile and link flags for libraries
  • ii cpp-3.3 3.3.5-2 The GNU C preprocessor
  • ii gcc-3.3 3.3.5-2 The GNU C compiler
  • ii gcc-3.3-base 3.3.5-2 The GNU Compiler Collection (base package)

root@debian:/home/joachim/bilderchen/flubb# dpkg -l | grep jack

  • ii libjack0.80.0-0 0.98.1-4 JACK Audio Connection Kit (libraries)
  • ii libjack0.80.0-dev 0.98.1-4 JACK Audio Connection Kit (development files)

root@knabber:/home/joachim/tmp/muse-stuff/0.7/muse# dpkg -l | grep libfluid

  • ii libfluidsynth-dev 1.0.4-2-1 Real-time MIDI software synthesizer (develop
  • ii libfluidsynth1 1.0.4-2-1 Real-time MIDI software synthesizer (runtime

root@knabber:/home/joachim/tmp/muse-stuff/0.7/muse# dpkg -l | grep libtool

  • ii libtool1.4 1.4.3-19 Generic library support scri

root@debian:/home/joachim/bilderchen/flubb# dpkg -l | grep libsnd

  • ii libsndfile1 1.0.10-2 Library for reading/writing audio files
  • ii libsndfile1-dev 1.0.10-2 Library for reading/writing audio files

root@knabber:/home/joachim/tmp/muse-stuff/0.7/muse# dpkg -l | grep ladc

  • ii ladcca-dev 0.4.0-4 Development files for LADCCA
  • ii ladcca2 0.4.0-4 LADCCA shared library files

Remove all previous versions of automake or you might run into problems: 

joachim@debian:~/tmp/muse-stuff/muse# dpkg --purge automake1.4
(Reading database ... 69071 files and directories currently installed.)
Removing automake1.4 ...

Point QTDIR to where your QT libraries are installed. ALSA and OSS are boolean values (ie. yes or no) that tell MusE how to handle Midi and Audio on your system. It is safe to say yes to both. 

export  QTDIR=/usr/share/qt3

Now run: ./configure --enable-maintainer-mode --disable-doxy-treeview --enable-optimize

Note that make install will ask for the root password, as MusE is installed as a setuid-root binary. Setuid-root is needed to allow MusE to get proper timing functions from the Linux kernel.

[edit]

configure parameters

If you have downloaded the cvs run ./autogen.sh first, if not type this: 

./configure --enable-maintainer-mode --disable-doxy-treeview --enable-optimize --enable-suid-install --enable-suid-build --enable-ladcca --enable-debug

But most users (not developers) might not want to use --enable-debug because of it's overhead.

Afterwards type make.

[edit]

Setuid-root

This should have been done by the MusE install script automatically but might not if you used a precompiled binary which doesn't do this steps on installation. About security read on here: MusE securty.

In case you can't start MusE because of a permission problem (if not beeing root), here is a quick and really dirty hack.

Change into the directory the MusE binary is in, and: 

chmod 0755 muse
chmod ug+s muse
chown root.users muse

Now you should be able to run MusE as normal user. You have to run qjackctl also with special privileges. If you have kernel 2.6.x with realtime LSM you have to load the module with: 

modprobe realtime allcaps=1

But be warned, don't do this on a multi-user-system because this IS really a lack of MusE securty to run a program as root from a normal user account.

BTW: If someone has a clear and better understanding of this, please write me and I'll change it then or if you got a wiki account already, change it yourself but test if it's working.

In case this does not work, you can also try this (no security anymore) because you are running MusE as root. Also note: realtime LSM module should be already loaded. 

kdesu qjackctl (start jackd from within)
kdesu muse

If I remeber correctly there is also some more documenation comming with the source distribution of MusE. Check the README.??? file.

Retrieved from "http://www.muse-sequencer.org/wiki/index.php/Installation"
Personal tools