README.html

   1 <!DOCTYPE html
   2     PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
   3     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   4 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
   5 <head>
   6  <title>Gajim - Read Me</title>
   7  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   8 </head>
   9 <body>
  10
  11 <h1>Gajim Read Me</h1>
  12
  13 <p>Welcome to Gajim and thank you for trying out our client.</p>
  14
  15 <h2>Runtime Requirements</h2>
  16 <ul>
  17 <li>python2.5 or higher</li>
  18 <li>pygtk2.16 or higher</li>
  19 <li>pysqlite2 (if you have python 2.5, you already have this)</li>
  20 </ul>
  21
  22 <h2>Optional Runtime Requirements</h2>
  23 <ul>
  24 <li><a href="http://pyopenssl.sourceforge.net/">PyOpenSSL</a> (python-pyopenssl package in Debian) (>=0.9) for <em>secure</em> SSL/TLS. Python's default SSL is insecure, so this package is highly recommended!</li>
  25 <li>python-crypto to enable End to end encryption</li>
  26 <li>For idle module, libxss library</li>
  27 <li>For zeroconf (bonjour), the "enable link-local messaging" checkbox, you need dbus-glib, python-avahi</li>
  28 <li>dnsutils (or whatever package provides the nslookup binary) for SRV support</li>
  29 <li>gtkspell and aspell-LANG where lang is your locale eg. en, fr etc</li>
  30 <li>gnome-python-desktop (for GnomeKeyring support as password storage)</li>
  31 <li>kwalletcli (for support of KDE Wallet as password storage)</li>
  32 <li>notification-daemon or notify-python (and D-Bus) to get cooler popups</li>
  33 <li>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.</li>
  34 <li>python-dbus bindings (>=0.81)</li>
  35 <li>python-kerberos to use GSSAPI authentification. Note: version1.1 or higher is required</li>
  36 </ul>
  37
  38 <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>
  39
  40 <h2>Compile-time Requirements</h2>
  41 <ul>
  42 <li>intltool (>= 0.40.1)</li>
  43 </ul>
  44
  45 <p><strong>NOTE:</strong> If you still have problems compiling, you may want to try removing the gtk1 series of the above dependencies.</p>
  46
  47 <h2>Installation Procedure</h2>
  48 <ol>
  49 <li>tar jxvf gajim-version.tar.bz2</li>
  50 <li>cd gajim</li>
  51 <li>./configure</li>
  52 <li>make (builds translations)</li>
  53 <li>su -c make install</li>
  54 </ol>
  55
  56 <p>To specify where to install do:</p>
  57 <pre>
  58     ./configure --prefix=custom_path
  59 </pre>
  60
  61 <h2>Running Gajim</h2>
  62 <p>Just do <em>gajim</em> or you can run Gajim from your GNOME/Xfce/KDE/whatever menus.<br/><br/>
  63 or if you use hg version and you didn't 'make install' you can also run from gajim folder with<em>./launch.sh</em></p>
  64 <hr />
  65 <h3>Note for hg users</h3>
  66 <p>You will need GNU autotools in order to install Gajim from svn. This includes:</p>
  67 <ul>
  68 <li>automake &gt;= 1.8 </li>
  69 <li>autoconf &gt;= 2.59 </li>
  70 <li>libtool</li>
  71 <li>intltool-0.40.1 </li>
  72 <li>pkgconfig &gt;= 0.19</li>
  73 </ul>
  74 <p>steps to compile gajim:</p>
  75 <pre>
  76     $ sh autogen.sh
  77     $ ./configure
  78     $ make
  79 </pre>
  80 <p>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:</p>
  81 <pre>
  82     $ ./configure
  83     $ make
  84 </pre>
  85 <h2>Uninstallation Procedure</h2>
  86 <pre>
  87     su -c make uninstall
  88 </pre>
  89 <p>this will try to remove Gajim from the default directories.
  90 If you want to remove it from custom directory provide it as:
  91 </p>
  92 <pre>
  93     ./configure --prefix=custom_path
  94     make uninstall
  95 </pre>
  96
  97 <h2>Miscellaneous</h2>
  98 <h3>XML &amp; Debugging</h3>
  99 <p>If you want to see the xml stanzas and/or help us debugging
 100 you're advised to enable verbose via advanced configuration window.
 101 If you don't want to make this permanent, execute gajim with --verbose
 102 everytime you want to have verbose output.</p>
 103
 104 <h3>FAQ/Wiki</h3>
 105 <p>FAQ can be found at <a href="http://trac.gajim.org/wiki/GajimFaq">http://trac.gajim.org/wiki/GajimFaq</a><br/>
 106 Wiki can be found at <a href="http://trac.gajim.org/wiki">http://trac.gajim.org/wiki</a></p>
 107
 108
 109 <p>That is all, <strong>enjoy!</strong></p>
 110
 111 <p>
 112 <br/>
 113 <br/>
 114 <br/>
 115 (C) 2003-2011<br/>
 116 The Gajim Team<br/>
 117 http://gajim.org<br/>
 118 <br/>
 119 <br/>
 120
 121 PS.
 122 We use original art and parts of sounds and other art from Psi, Gossip,
 123 Gnomebaker, Gaim and some icons from various gnome-icons
 124 (mostly Dropline Etiquette) we found at art.gnome.org
 125 If you think we're violating a license please inform us. Thank you.</p>
 126 </body></html>