159 lines
4.7 KiB
HTML
159 lines
4.7 KiB
HTML
<!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>
|
|
<li>pygtk2.8 or higher</li>
|
|
<li>python-libglade</li>
|
|
<li>pysqlite2 (if you have python 2.5, you already have this)</li>
|
|
</ul>
|
|
|
|
<p>
|
|
<strong>Note to packagers</strong>
|
|
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.
|
|
</p>
|
|
|
|
<h2>Optional Runtime Requirements</h2>
|
|
<ul>
|
|
<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>
|
|
<li>python-crypto to enable End to end encryption</li>
|
|
<li>For idle module, libxss library</li>
|
|
<li>For zeroconf (bonjour), the "enable link-local messaging" checkbox, you need dbus-glib, python-avahi</li>
|
|
<li>dnsutils (or whatever package provides the nslookup binary) for SRV support</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>
|
|
<li>D-Bus running to have gajim-remote working. Some distributions split dbus-x11, which is needed for dbus to work with Gajim.</li>
|
|
<li>python-dbus bindings</li>
|
|
<li>python-sexy to have clickable URLs in chat windows</li>
|
|
<li>python-kerberos to use GSSAPI authentification. Note: version1.1 or higher is required</li>
|
|
</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>
|
|
<li>libdbus-1-dev (for the remote control module)</li>
|
|
<li>intltool (>= 0.40.1)</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>
|
|
<li>cd gajim</li>
|
|
<li>./configure</li>
|
|
<li>make (builds all modules)</li>
|
|
<li>su -c make install</li>
|
|
</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
|
|
<em>./launch.sh</em></p>
|
|
<hr />
|
|
<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.40.1 </li>
|
|
<li>pkgconfig >= 0.19</li>
|
|
</ul>
|
|
</p>
|
|
steps to compile gajim:
|
|
<pre>
|
|
$ sh autogen.sh
|
|
$ ./configure
|
|
$ make
|
|
</pre>
|
|
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>
|
|
<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>
|
|
<h3>XML & Debugging</h3>
|
|
<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>
|
|
FAQ can be found at <a href="http://trac.gajim.org/wiki/GajimFaq">http://trac.gajim.org/wiki/GajimFaq</a><br/>
|
|
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/>
|
|
(C) 2003-2008<br/>
|
|
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>
|