# Gajim Read Me

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

## Runtime Requirements

- python2.4 or higher
- pygtk2.8 or higher
- python-libglade
- pysqlite2 (if you have python 2.5, you already have this)

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

- PyOpenSSL (python-pyopenssl package in Debian) for secure SSL/TLS. Python's default SSL is insecure, so this package is highly recommended!
- python-crypto to enable End to end 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; if you don't know what that is, you don't need it
- gtkspell and aspell-LANG where lang is your locale eg. en, fr etc
- GnomePythonExtras 2.10 or above (aka gnome-python-desktop) so you can avoid compiling trayicon and gtkspell
- gnome-python-desktop (for GnomeKeyring support)
- notification-daemon or notify-python (and D-Bus) to get cooler popups
- D-Bus running to have gajim-remote working
- python-dbus bindings
- python-sexy to have clickable URLs in chat windows

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

- python-dev
- python-gtk2-dev
- libgtk2.0-dev aka. gtk2-devel
- libxss-dev (for idle detection module; some distributions such as Debian split xscreensaver)
- libgtkspell-dev (for the gtkspell module)
- libdbus-1-dev (for the remote control module)
- intltool

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: su -c make PREFIX=custom_path install

## 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 ./launch.sh

### Note for svn users

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

- automake >= 1.8
- autoconf >= 2.59
- libtool
- intltool-0.35.0
- pkgconfig >= 0.19

steps to compile gajim:

        $ sh 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:
make PREFIX=custom_path 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 http://trac.gajim.org/wiki/GajimFaq
Wiki can be found at http://trac.gajim.org/wiki

That is all, enjoy!

(C) 2003-2006
The Gajim Team
http://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.