Gajim Read Me

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

Runtime Requirements

• python3.4 or higher
• python3-gi
• python3-gi-cairo
• gir1.2-gtk-3.0
• python3-nbxmpp

Optional Runtime Requirements

• python3-openssl (>=0.14) for secure SSL/TLS. Python's default SSL is insecure, so this package is highly recommended!
• python3-pyasn1 to check SSL/TLS certificate
• python3-crypto to enable End to end encryption
• python3-gnupg to enable GPG encryption
• For zeroconf (bonjour), the "enable link-local messaging" checkbox, you need dbus-glib, python-avahi
• dnsutils (or whatever package provides the nslookup binary) for SRV support
• gir1.2-gtkspell3-3.0 and aspell-LANG where lang is your locale eg. en, fr etc
• gir1.2-secret-1 for GNOME Keyring or KDE support as password storage
• gir1.2-notify-0.7 to get cooler popups
• D-Bus running to have gajim-remote working. Some distributions split dbus-x11, which is needed for dbus to work with Gajim. Version >= 0.80 is required.
• python3-dbus bindings (>=1.2.0)
• gir1.2-farstream-0.2, gir1.2-gstreamer-1.0 and gir1.2-gst-plugins-base-1.0 for audio and video calls
• gir1.2-gupnpigd-1.0 for better NAT traversing
• gir1.2-networkmanager-1.0 for network lose detection
• python3-idna and python3-precis-i18n for correctly parsing JIDs

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

• intltool (>= 0.40.1)
• pkg-config
• libtool

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 translations)
5. su -c make install

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 use Git version and you didn't 'make install' you can also run from gajim folder with./launch.py

Note for Git users

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

• automake >= 1.8
• autoconf >= 2.59
• libtool
• intltool-0.40.1
• pkgconfig >= 0.19

steps to compile gajim:

    $ ./autogen.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

Miscellaneous

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/Wiki

FAQ can be found at https://dev.gajim.org/gajim/gajim/wikis/help/gajimfaq
Wiki can be found at https://dev.gajim.org/gajim/gajim/wikis/home

That is all, enjoy!

(C) 2003-2017
The Gajim Team
https://gajim.org


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 art.gnome.org If you think we're violating a license please inform us. Thank you.