Install

Andreas Degert Daniel Thompson (Merlin) Gaius Baltar

Distributions that include Guitarix

Unless you want to live right on the bleeding edge then using the version of guitarix provided by your GNU/Linux distribution is the fastest, easiest way to get started with guitarix.

Although few distributions included guitarix in the default install most have a copy in their repositories. The following distributions are known do the later:

Note: If your distribution is not listed above but you know guitarix is included in its repositories then please add it to the above list.

Building Guitarix from source code

Guitarix uses 'waf' for the build environment. The simplest and fastest way to build Guitarix is given below:

Unpack the archive you can download on our Sourceforge-page:

tar -xvjf gx_head-0.14.0.tar.bz2

or fetch the current development version from git:

git clone git://git.code.sf.net/p/guitarix/git guitarix

Please be aware, that the git-version is not an official release. It is bleeding edge, untested and not supposed to build an application for daily use from. So, if you build Guitarix from git and it works for you, we congratulate, if it does not, refetch (use "git pull"), rebuild, check again then send a bug-report.

Regardless if you have fetched the sources from git or unpacked them from our official release-tarball, the next steps would be:

cd guitarix_source_directory
./waf configure
./waf build
sudo ./waf install

By default, this will install Guitarix and related files in the /usr/local filesystem, e.g. /usr/local/bin. The installation prefix can be provided at configure time, e.g.:

./waf configure --prefix=/usr
./waf build
sudo ./waf install

Thus, Guitarix will be installed in /usr/bin.

Dependencies

To obtain the latest git version, you have to install the 'git' package. Like the build-system, this is available from most of the repositories.

To compile and run guitarix properly, you will need a build-system (build-essentials, gcc etc.) and the following extra packages (runtime binaries / libraries and developement packages, aka package-dev or package-devel):

   python
   libjack-dev
   libsndfile1-dev
   libgtk2.0-dev
   ladspa-sdk
   libgtkmm-2.4-dev
   libboost-dev
   intltool

(These are Debian package names. In other distributions the packages often have similar names.)

In Debian based distributions which contain an older version of Guitarix you can often start with installing the build-dependencies of that version:

sudo apt-get install build-essential sudo apt-get build-dep guitarix

"./waf configure" will tell you which packages are still missing or which newer versions are needed. We try to keep compatible with the latest Debian stable release.


Related

Wiki: Main_Page