Compiling

Table of Contents Do I Need to Compile Freewheeling? Compiling Prerequisites Compile Troubleshooting

Do I Need to Compile Freewheeling?

Freewheeling binaries and dependencies are available for many of today's popular operating systems in their package repositories (for some distros you may have to configure some third-party repositories).

• NOTE: Most Arch, Debian, Fedora, KxStudio, Manjaro, Mint, OpenSuse, Parabola, and Ubuntu users will not need to compile; but can simply install OS Specific Packages.

If your OS does not have Freewheeling in their repos you may still be able to download an installer package (.deb, .rpm, PKGBUILD, ebuild) for your system. See the OS Specific Packages page. If not, you can always compile Freewheeling on most every GNU/Linux system.

Compiling

Packaging, testing, and distribution take time, so downstream versions tend to lag a bit. If you need badly the last bleeding-edge version read on ...

Prerequisites

The ./configure script may warn you for missing libraries. For this to work properly, you need to have a number of libraries installed. You may need to configure thirtd-party repositories for these commands to work on your system or download and compile some dependencies manually. These are the dependencies required to compile Freewheeling on the following popular distros:

• Arch, Manjaro, Parabola

  pacman -S 'base-devel' 'fluidsynth' 'liblo' 'libxml2' 'nettle' 'sdl_gfx' 'sdl_ttf'

• Debian, KxStudio, Mint, Ubuntu

  sudo apt-get build-dep freewheeling

or,

  sudo apt-get install build-essential nettle-dev libfreetype6-dev libsdl-gfx1.2-dev \
                       libsdl-ttf2.0-dev liblo-dev libxml2-dev libvorbis-dev         \
                       libsndfile1-dev libjack-jackd2-dev

• Fedora

  su -c 'dnf install libtool gcc-c++ nettle-devel freetype-devel SDL_gfx-devel   \
                     SDL_ttf-devel liblo-devel jack-audio-connection-kit-devel   \
                     libsndfile-devel libxml2-devel libICE-devel libvorbis-devel

• NOTE: If you want to use Freewheeling's integrated software synthesizer, then you will also need to install the Fluidsynth development files (e.g. by installing the fluidsynth, libfluidsynth-dev or fluidsynth-devel packages). Freewheeling currently is compatible with Fluidsynth v1 and v2.

Compile

Download and unpack the source tarball if necessary then cd into your fresh ./freewheeling* sources directory and run the following commands:

Most user should be able to compile with only these commands:

  ./configure
  make
  sudo make install

Optional: The Freewheeling source code conforms to the GNU specification; so if you have autotools installed, you can reconfigure before compiling with:

  autoreconf -ivf

If there is a problem compiling, try installing autoconf and automake then run these commands to recreate the Makefiles:

  autoconf
  automake

If they complain, run:

  autoheader
  autoreconf -ivf
  automake --add-missing

... then recompile as above.

To launch Freewheeling from the command line, run:

  fweelin

Troubleshooting

First, scratch your head a few times and ask your favorite search engine for help. It is quite likely that your problem is a common one that is not specific to Freewheeling. If you cannot resolve the issue on your own in this way, please do send a message to the Freewheeling mailing list.