Tree [31af6a] V0.22.1 / trunk /

HTTPS access

File Date Author Commit
 IR 2011-01-24 hermann hermann [e89318] add factory settings contributed by zettberlin
 data 2012-02-02 Andreas Degert Andreas Degert [8e763c] enhanced UI / work in progress
 debian 2012-03-29 Andreas Degert Andreas Degert [cb460c] debian/control: added python2.6 as alternative ...
 factorysettings 2012-04-14 Andreas Degert Andreas Degert [c31a36] vibe factory presets: correct some values
 glade-gxw 2011-12-19 Andreas Degert Andreas Degert [048749] added racktuner widget; change openMonoRackBox ...
 ladspa 2011-09-20 hermann hermann [c4014a] fix debian Bug#640790guitarix: Makes jack-rack ...
 libgxw 2012-04-12 Andreas Degert Andreas Degert [af7cc8] GxRegler: set default for round_digits to -1 an...
 libgxwmm 2012-04-07 Andreas Degert Andreas Degert [acc1d5] fix comparisons of gain lines
 pixmaps 2012-03-03 Andreas Degert Andreas Degert [24f2fe] Fixed text logging box, added status icons
 po 2012-03-25 Andreas Degert Andreas Degert [2b069a] some updates in po dir
 pygxw 2011-12-19 Andreas Degert Andreas Degert [048749] added racktuner widget; change openMonoRackBox ...
 rcstyles 2012-04-07 hermann hermann [d69fab] add and make frquency sp...
 src 2012-04-18 Andreas Degert Andreas Degert [0b417f] fix: changed "requires" tag for gtk+ to 2.20 in...
 tools 2012-04-14 Andreas Degert Andreas Degert [67de49] pluginloader.pyx: add plugin index to ctor, fix...
 wafadmin 2012-01-16 hermann hermann [5bb9e9] replace waf 'binary' with the waf source to ful...
 COPYING 2012-04-05 Andreas Degert Andreas Degert [cefb17] changed COPYING to reflect current state
 README 2012-02-02 hermann hermann [855765] updated README
 README.developers 2011-12-05 Andreas Degert Andreas Degert [0ad533] GxPaintBox: based on GtkBox, removed unnecessar...
 changelog 2011-06-14 hermann hermann [38f240] update wscript, switch to use guitarix as binar... 2011-11-09 Andreas Degert Andreas Degert [b0bc21] added create_selector to UiBuilder; Logger: cap...
 waf 2012-01-16 hermann hermann [5bb9e9] replace waf 'binary' with the waf source to ful...
 wscript 2012-04-18 Andreas Degert Andreas Degert [31af6a] version 0.22.1 2011-11-12 Andreas Degert Andreas Degert [60ba72] don't redirect gx_print_xxx with idle signal be...

Read Me


Guitarix is a simple mono amplifier to be used in a 'JACKified'
environment, i.e. a system using the JACK Audio Connection Kit, a
professionally-capable audio/MIDI server and master transport control,
available here:

Guitarix provides one JACK input port and two JACK output ports. It is 
designed to produce nice trash/metal/rock/blues guitar sounds. Controls 
for bass, treble, gain, compressor, tube selector, distortion, flanger,
freeverb, crybaby (wah) and . . . . are available.

======================= Building guitarix from source code

---- Build environment

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

  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.
Check for all options :

 ./waf --help

---- Dependencies 

To compile and run properly guitarix needs the following extra
packages (runtime binaries/libraries and development packages):

  GTK+-2.0 >= 2.20
  libsndfile  >= 1.0.17
  JACK (jackd, libjack, and their development packages) >= 0.116.2
  gtkmm-2.4 >= 2.24
  fftw3f >= 3.1.2

By the way, most package managers usually list development packages as 
'packagename-dev', e.g. libsndfile-dev.

---- Debian

To build a Debian package, run "dpkg-buildpackage -rfakeroot -b"

==================== Startup options

Guitarix provides a few user options at startup.
Check from the command line the usual -h, 
--help or --help-all options:

==================== JACK startup when JACK isn't running

Guitarix will pop up a JACK start dialog window if it finds that jackd
is not running.

The user can choose to activate JACK or exit guitarix.  Note that the
supported methods for starting JACK are (by preference order):

1- qjackctl --start
2- Use of $HOME/.jackdrc

=========== Extra information


Guitarix also comes as a suite of LADSPA plugins. If the user wishes
to use guitarix or some of its effects in a LADSPA host (e.g. Ardour),
the guitarix plugins are available. They are installed by default in


where PREFIX is either /usr or /usr/local.



We use FAUST to build the prototype and will say thanks
to the following contributors:

        : Julius Smith <>
		: Albert Graef <>
		: Yann Orlary <>

Enjoy! :)

If you encounter problems building or running guitarix, please inform us.