Compiling lmms

Tres Finocchiaro edited this page Apr 26, 2017 · 48 revisions

This tutorial has moved here: Compiling

Please update your bookmarks

Below is kept temporarily for reference purposes only and will soon be removed


The following dependencies should be met before compiling LMMS:

Required libraries:

Optional, but strongly recommended (with devel-files each):

The last four dependencies on the list are necessary for audio playback. You may provide one or more of those, depending on what sound server(s) you'd like to use with LMMS.

For building, you'll also need:

  • GCC with g++
  • CMake (>= 2.4.5 required, >=2.6.0 recommended)

For example, for installing all dependencies on Ubuntu 12.04 (or later) at once, run:

sudo apt-get build-dep lmms && sudo apt-get install libfltk1.3-dev

Or, manually:

sudo apt-get install build-essential cmake libqt4-dev libsndfile1-dev libfftw3-dev \
libvorbis-dev libogg-dev libasound2-dev libjack-dev libsdl-dev libsamplerate0-dev \
libstk0-dev libfluidsynth-dev portaudio19-dev libfltk1.3-dev wine-dev \
libxinerama-dev libxft-dev libgig-dev git

On 64 bits systems you may also have to:

sudo apt-get install libc6-dev-i386 gcc-multilib g++-multilib

(Fixes "compilation terminated. winegcc: g++ failed")

On other Debian-based systems, run instead:

sudo apt-get install cmake ladspa-sdk libsamplerate0-dev libsdl1.2-dev \
	libsndfile1-dev libvorbis-dev libjack-dev libstk0-dev libfltk1.3-dev \
	fluid libasound2-dev libqt4-dev libpulse-dev libfluidsynth-dev \
	libfftw3-dev portaudio19-dev qt4-qmake libgig-dev libwine-dev

On Debian i386 systems, also run:

sudo apt-get install wine32-tools

Other architectures are not able to compile support for VST plug-ins.

Building on Linux

Note for Ubuntu users: You may run into problems compiling LMMS on Ubuntu 12.04 or above, as the ia32-libs package has been removed from the repositories. See this page for more information:

Note for Fedora users: For 32-bit VST support wine.i686 and wine-devel.i686 are required.

Instructions on compiling and installing LMMS:

  1. Assuming you have already fetched the sources (see Accessing git repository if not), switch to the source root directory, and create a new directory which is needed for you build.

    mkdir build
  2. Then configure LMMS with CMake.

    cd build
    cmake ..

    This will search your system for all the dependencies and will notify you if something's missing.


    • On some Debian based systems if VST fails to locate wine-dev, append -DWINE_LIBRARY=/usr/lib/i386-linux-gnu/ To enable VST support on non-i386 systems, append -DWANT_VST_NOWINE=1; an i386 RemoteVstPlugin is needed.
    • To include debugging symbols usable with tools like gdb and valgrind, pass the debug flag into cmake: -DCMAKE_BUILD_TYPE=DEBUG, or -DCMAKE_BUILD_TYPE=RelWithDebInfo for a good compromise between program optimization and ability to debug.
    • To specify a install directory different from the default one, invoke cmake with the option -DCMAKE_INSTALL_PREFIX=<install-dir>.
  3. Now compile LMMS: (People with more than one CPU core can use make's -j<n> option, with being the number of threads you wish to use, accelerating the process. Otherwise make is just fine. )

    make -j2
  4. Run it:


    Note: This will automatically create a file ~/.lmmsrc.xml which will map artwork and plugin paths relative to your build directory. At any time, if artwork or plugins stop loading properly, you will need to edit, move or delete ~/.lmmsrc.xml to correct these paths.

  5. Optionally, install LMMS into the previously specified directory:

    sudo make install
  6. Note: If you have an older version of LMMS installed, you may run into some GUI problems and glitches. This is because LMMS 1.0.0 is no longer compatible with old 0.4.x themes. To solve the problem:

    • Run LMMS
    • Go to settings and select the folder tab
    • Clear the "artwork directory" setting so that it's empty
    • Restart LMMS

Using Qt5


  • CMake >= 2.8.11 is required for building with Qt5 support.
  • Additional build dependencies: qtbase5-dev qttools5-dev-tools qttools5-dev


  • In order to build LMMS with Qt5, add the following flag when invoking cmake:


  • If your Qt5 installation does not reside in standard installation paths, additionally pass e.g.