2006-10-05 23:47:50 +00:00
< !DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
< html xmlns = "http://www.w3.org/1999/xhtml" lang = "en" xml:lang = "en" >
< head >
< title > Gajim - Read Me< / title >
< / head >
< body >
< h1 > Gajim Read Me< / h1 >
< p >
Welcome to Gajim and thank you for trying out our client.
< / p >
< h2 > Runtime Requirements< / h2 >
< ul >
< li > python2.4 or higher< / li >
2007-08-09 22:01:36 +00:00
< li > pygtk2.8 or higher< / li >
2006-10-05 23:47:50 +00:00
< li > python-libglade< / li >
< li > pysqlite2 (if you have python 2.5, you already have this)< / li >
< / ul >
< p >
< strong > Note to packagers< / strong >
2006-10-29 13:52:41 +00:00
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.
2006-10-05 23:47:50 +00:00
< / p >
< h2 > Optional Runtime Requirements< / h2 >
< ul >
2007-01-05 23:44:36 +00:00
< li > < a href = "http://pyopenssl.sourceforge.net/" > PyOpenSSL< / a > (python-pyopenssl package in Debian) for < em > secure< / em > SSL/TLS. Python's default SSL is insecure, so this package is highly recommended!< / li >
2007-08-27 13:36:24 +00:00
< li > python-crypto to enable End to end encryption< / li >
2008-12-03 23:00:05 +00:00
< li > For idle module, libxss library< / li >
2007-01-05 23:50:53 +00:00
< li > For zeroconf (bonjour), the "enable link-local messaging" checkbox, you need dbus-glib, python-avahi< / li >
2006-10-05 23:47:50 +00:00
< li > dnsutils (or whatever package provides the nslookup binary) for SRV support; if you don't know what that is, you don't need it< / li >
< li > gtkspell and aspell-LANG where lang is your locale eg. en, fr etc< / li >
< li > GnomePythonExtras 2.10 or above (aka gnome-python-desktop) so you can avoid compiling trayicon and gtkspell< / li >
< li > gnome-python-desktop (for GnomeKeyring support)< / li >
< li > notification-daemon or notify-python (and D-Bus) to get cooler popups< / li >
2006-10-30 10:19:40 +00:00
< li > D-Bus running to have gajim-remote working< / li >
< li > python-dbus bindings< / li >
2007-10-09 17:48:22 +00:00
< li > python-sexy to have clickable URLs in chat windows< / li >
2008-12-17 09:30:11 +00:00
< li > python-kerberos to use GSSAPI authentification. Note: version1.1 or higher is required< / li >
2006-10-05 23:47:50 +00:00
< / ul >
< p >
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.
< / p >
< h2 > Compile-time Requirements< / h2 >
< ul >
< li > python-dev< / li >
< li > python-gtk2-dev< / li >
< li > libgtk2.0-dev aka. gtk2-devel< / li >
< li > libgtkspell-dev (for the gtkspell module)< / li >
2008-06-27 09:28:26 +00:00
< li > libdbus-1-dev (for the remote control module)< / li >
2006-10-05 23:47:50 +00:00
< li > intltool< / li >
< / ul >
< p >
< strong > NOTE:< / strong >
If you still have problems compiling, you may want to try removing the gtk1 series of the above dependencies.
< / p >
< h2 > Installation Procedure< / h2 >
< ol >
< li > tar jxvf gajim-version.tar.bz2< / li >
2006-10-11 23:55:03 +00:00
< li > cd gajim< / li >
< li > ./configure< / li >
< li > make (builds all modules)< / li >
< li > su -c make install< / li >
2006-10-05 23:47:50 +00:00
< / ol >
< p >
To specify what modules to build do:
make help
< / p >
< p >
To specify where to install do:
su -c make PREFIX=custom_path install
< / p >
< h2 > Running Gajim< / h2 >
< p >
Just do < em > gajim< / em > or you can run Gajim from your GNOME/XFCE/KDE/whatever menus.< br / > < br / >
or if you didn't 'make install' you can also run from gajim folder with
2006-12-03 14:41:17 +00:00
< em > ./launch.sh< / em > < / p >
< hr / >
2006-10-11 23:55:03 +00:00
< h3 > Note for svn users< / h3 >
You will need GNU autotools in order to install Gajim from svn. This includes:
< ul >
< li > automake > = 1.8 < / li >
< li > autoconf > = 2.59 < / li >
< li > libtool< / li >
< li > intltool-0.35.0 < / li >
2006-10-15 10:32:17 +00:00
< li > pkgconfig > = 0.19< / li >
2006-10-11 23:55:03 +00:00
< / ul >
2006-10-05 23:47:50 +00:00
< / p >
2006-10-11 23:55:03 +00:00
steps to compile gajim:
< pre >
$ sh autogen.sh
$ ./configure
$ make
< / pre >
2006-10-15 10:32:17 +00:00
Alternatively, if you don't want to install all these packages, you can get a nightly snapshot from < a href = "http://www.gajim.org/downloads/snap/" > here< / a > and procede as usual:
< pre >
$ ./configure
$ make
< / pre >
2006-10-05 23:47:50 +00:00
< h2 > Uninstallation Procedure< / h2 >
< p >
su -c make uninstall< br / >
this will try to remove Gajim from the default directories.
If you want to remove it from custom directory provide it as:< br / >
make PREFIX=custom_path uninstall
< / p >
< h2 > Miscellaneous< / h2 >
2006-12-03 14:41:17 +00:00
< h3 > XML & Debugging< / h3 >
2006-10-05 23:47:50 +00:00
< p >
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.
< / p >
< h3 > FAQ/Wiki< / h3 >
< p >
2006-10-05 23:50:26 +00:00
FAQ can be found at < a href = "http://trac.gajim.org/wiki/GajimFaq" > http://trac.gajim.org/wiki/GajimFaq< / a > < br / >
2006-10-05 23:47:50 +00:00
Wiki can be found at < a href = "http://trac.gajim.org/wiki" > http://trac.gajim.org/wiki< / a >
< / p >
< p >
That is all, < strong > enjoy!< / strong >
< / p >
< p >
< br / >
< br / >
< br / >
2008-10-22 21:15:16 +00:00
(C) 2003-2008< br / >
2006-10-05 23:47:50 +00:00
The Gajim Team< br / >
http://gajim.org< br / >
< br / >
< br / >
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.
< / p >
< / body > < / html >
