Installing OOM

ccherrett edited this page Apr 14, 2012 · 166 revisions

Ubuntu packages can be found as PPAs here:

Gentoo users can install like this:

layman -a oomidi

GIT clone the Latest development source code from here:

git clone git://

Download the OpenOctaveMidi-2011 source code from here:




**OpenOctaveMidi is an opensource project, licensed as GPL v2**.

The following Linux Distributions have pre-packaged binaries of OOMidi-2011.


This page contains the following sections:

  • Installation
  • Requirements
  • Installing Linuxsampler
  • Install Sample Libraries
  • Compiling from Source
  • Starting OOM


For those who want to build from source, ensure you have the following installed.

Please note. If some distros provide specifically built packages for OOM, those distros may split required libs and packages into something like “foo”, and “foo-dev”, so you may need to search for development packages if this is the case. We do not support or answer queries for distro specific problems or challenges. Please communicate with your distro packaging specialists.

OOMidi is distributed under the GNU General Public License (GPL).


Installing Linuxsampler

Open Octave Studio relies heavily on Linuxsampler and needs current versions of liblscp, libgig and linuxsampler that have sfz support.

Ensure that you download and install the latest version of Liblscp, which can be downloaded with:

svn co liblscp

Ensure that you download and install the latest version of Libgig, which can be downloaded with:

svn co libgig

Note that libgig must be installed before linuxsampler.

The latest build of Linuxsampler can be found in their Subversion repository, and can be downloaded with:

svn co linuxsampler

cd to each directory in turn, and build the apps from there.

Follow the instructions in the included INSTALL files for each download. Note that the following command will need to be issued first, in each case, in order to create configuration files from svn downloads:

make -f Makefile.cvs

Once you've built Linuxsampler and the libs, and got everything correctly up and running with GIG and SFZ support, then you're ready for the next part of the process.

Note that if you install the 3 Linuxsampler builds from a repo, the builds MUST be the latest svn builds. In Gentoo, we can do this with the "9999" ebuild. If your distro based versions are too old, then you'll need to build from svn, as described above.

You can check that your linuxsampler version is current svn by doing this from a command line:

linuxsampler --version

This results in something like this on my computer:

LinuxSampler 1.0.0.svn18

If it says something like this:

LinuxSampler 1.0.0.cvs10

You have the wrong version. Linuxsampler is no longer in a cvs repository. So please follow the above instructions and uninstall the linuxsampler, libgig and liblscp you are running.

Install Sample Libraries

Open Octave Provides a great starting point for making music using samples. You must download the samples to use them. To download samples do the following:

run: oostudio, go to the Downloads tab and download the samples you would like to use. Easy!

Compiling OOMidi-2011 from source

or just use a graphical de-compressor to unpack it somewhere.

To compile OOMidi, run the following command from the top level directory where the source code was unpacked (the directory where the README file is):


OOM is installed by default into /usr/local.

Then cd into the build directory with:

     cd build

Compile OOM with the following command:

  sudo make install 


OOM tracks will only accept input if the track is Record Armed.

Go to the track header you selected and press the Record button. It will show red.

Play your keyboard, and you should have sound.

The team and fellow users can be found on IRC, at #openoctave (freenode) You can also use the Live Support feature on our website here:

Starting OOM

OOM can be started by typing:


For most users, the majority of these options will be unnecessary, but may prove useful to experienced linux users with some debugging skills who have encountered a local problem.

  • OOM Configuration File /home/user/.config/OOMidi/OOMidi.cfg
  • Hidden Project File; stores list of last projects /home/user/.config/OOMidi/projects
  • Instrument folder of instrument sets /home/user/.config/OOMidi/Instruments/

OOM recognizes the following file types:

Default OOM format


midi file; can be imported and exported


karaoke: midi file with additional information; some types can be imported


Stored midi parts, these are an alternative way of storing structures in OOM.


Stored plugin presets


You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.