Gajim Read Me

Welcome to Gajim and thank you for trying out our client.

Runtime Requirements

Note to packagers Gajim is a GTK+ app that loves GNOME. You can do 'make' so you don't require gnomepythonextras (aka gnome-python-desktop) which is gnome dep, but you will miss gnomekeyring integration.

Optional Runtime Requirements

Some distributions also split too much python standard library. I know SUSE does. In such distros you also need python-xml the xml lib that *comes* with python and not pyxml or whatever.

Compile-time Requirements

NOTE: If you still have problems compiling, you may want to try removing the gtk1 series of the above dependencies.

Installation Procedure

  1. tar jxvf gajim-version.tar.bz2
  2. cd gajim
  3. ./configure
  4. make (builds all modules)
  5. su -c make install

To specify what modules to build do:

    make help

To specify where to install do:

    ./configure --prefix=custom_path

Running Gajim

Just do gajim or you can run Gajim from your GNOME/Xfce/KDE/whatever menus.

or if you didn't 'make install' you can also run from gajim folder with./

Note for hg users

You will need GNU autotools in order to install Gajim from svn. This includes:

steps to compile gajim:

    $ sh
    $ ./configure
    $ make

Alternatively, if you don't want to install all these packages, you can get a nightly snapshot from here and procede as usual:

    $ ./configure
    $ make

Uninstallation Procedure

    su -c make uninstall

this will try to remove Gajim from the default directories. If you want to remove it from custom directory provide it as:

    ./configure --prefix=custom_path
    make uninstall


XML & Debugging

If you want to see the xml stanzas and/or help us debugging you're advised to enable verbose via advanced configuration window. If you don't want to make this permanent, execute gajim with --verbose everytime you want to have verbose output.


FAQ can be found at
Wiki can be found at

That is all, enjoy!

(C) 2003-2010
The Gajim Team

PS. We use original art and parts of sounds and other art from Psi, Gossip, Gnomebaker, Gaim and some icons from various gnome-icons (mostly Dropline Etiquette) we found at If you think we're violating a license please inform us. Thank you.