Add gajim

doc/EN/usage.org

@@ -388,6 +388,32 @@ Select /Administrator controls/ then *IRC Menu* and then change the password. An
 ** XMPP/Jabber
 *** About XMPP
 A well written article on the state of XMPP and how it compares to other chat protocols [[https://gultsch.de/xmpp_2016.html][can be found here]].
+*** Using with Gajim
+In mid 2016 Gajim became the first desktop XMPP client to support the new OMEMO end-to-end security standard, which is superior to the more traditional OTR since it also includes multi-user char and the ratcheting mechanism pioneered by Open Whisper Systems. To install it:
+
+#+begin_src bash :tangle no
+su -c 'echo "deb ftp://ftp.gajim.org/debian unstable main" > /etc/apt/sources.list.d/gajim.list'
+sudo apt-get update
+sudo apt-get -y install gajim-dev-keyring
+sudo apt-get -y install git tor python-dev python-pip gajim-nightly
+mkdir ~/.local/share/gajim/plugins -p
+cd ~/.local/share/gajim/plugins
+git clone https://github.com/omemo/gajim-omemo
+sudo pip install protobuf==2.6.1, python-axolotl==0.1.35
+#+end_src
+
+Open Gajim and enter your XMPP address and password.
+
+Go to *Edit/Preferences* and select the *Advanced* tab. Under *Global Proxy* select *Tor* and the *Close* button. Then select *Edit/Plugins* and make sure that OMEMO is active (ticked), then select the *Close* button.
+
+When you start a conversation make sure that the OMEMO box is ticked. You can also click on the keys button and trust various fingerprints. Both sides will need to do that before an encrypted chat can start.
+
+If you wish to make backups of the OMEMO keys then they can be found within:
+
+    ~/.local/share/gajim
+
+If you wish to use OpenPGP to encrypt your messages then go to *Edit/Accounts*, select your account and then the *Personal Information* tab. You can then choose your GPG key. When initiating a chat you can select the *Advanced* button and then select *Toggle OpenPGP Encryption*. OpenPGP is not as secure as OMEMO, but does allow you to use XMPP in a similar style to email in that the recipient of the message does not necessarily need to be online at the same time that you send it.
+
 *** Using with Profanity
 The [[http://profanity.im][Profanity]] shell based user interface and is perhaps the simplest way to use XMPP from a laptop. It's also a good way to ensure that your OTR keys are the same even when logging in from different laptops or devices, and it also means that if those devices later become compomised then there are no locally stored OTR keys to be found.