Difference between revisions of "Gajim"

From ArchWiki
Jump to: navigation, search
(gajim <= 0.13)
(Installation: Add section title.)
(22 intermediate revisions by 4 users not shown)
Line 1: Line 1:
== Gajim and OTR ==
+
[[Category:Internet Applications]]
 +
[[Category:Security]]
  
 
'''OTR''' (off-the-record) encryption is strong end-to-end encryption protocol for instant messaging ([http://www.cypherpunks.ca/otr/ read more]). OTR hasn't any XMPP XEP, because OTR is of cross-protocol nature.  
 
'''OTR''' (off-the-record) encryption is strong end-to-end encryption protocol for instant messaging ([http://www.cypherpunks.ca/otr/ read more]). OTR hasn't any XMPP XEP, because OTR is of cross-protocol nature.  
Line 5: Line 6:
 
And '''Gajim''' is a powerful XMPP-client without OTR support out-of-the-box.
 
And '''Gajim''' is a powerful XMPP-client without OTR support out-of-the-box.
  
== Gajim >= 0.15 ==
+
== Gajim >= 0.15 (or gajim-hg) ==
  
Since version 0.15, Gajim has powerful plugin system. One plugin named [http://trac-plugins.gajim.org/wiki/OffTheRecordPlugin gotr] is an modern OTR implementation from Kjell Bradden.
+
Since version 0.15, Gajim has powerful plugin system. The [http://trac-plugins.gajim.org/wiki/OffTheRecordPlugin gotr] plugin is used to provide OTR encryption, and it depends on ''python-potr'', the modern OTR protocol implementation written on python by Kjell Bradden.
  
To install it follow these simple steps:
+
== Installation ==
 +
To install the plugin follow these simple steps:
  
# Be sure, that currently installed version of gajim >= 0.15. If 0.15 version is not available, install [http://aur.archlinux.org/packages.php?ID=27152 aur:gajim-hg];
+
# Install [https://aur.archlinux.org/packages.php?ID=56560 aur:pure-python-otr-git];
# Install [http://aur.archlinux.org/packages.php?ID=51501 aur:python-potr];
+
 
# Install/update the gajim plugins from hg.
 
# Install/update the gajim plugins from hg.
## Install mercurial: ''$ sudo pacman -S mercurial''
+
## To go through next steps, you need mercurial (a popular DVCS) installed: <pre>$ sudo pacman -S mercurial</pre>
## Go to gajim plugins directory: ''$ mkdir -p ~/.local/share/gajim/plugins/; cd ~/.local/share/gajim/plugins/''
+
## Go to gajim plugins directory:<pre>$ mkdir -p ~/.local/share/gajim/plugins/; cd ~/.local/share/gajim/plugins/</pre>
## (at first time) Download all plugins: ''hg clone http://hg.gajim.org/gajim-plugins/ .''
+
## (at first time) Download all plugins: <pre>$ hg clone http://hg.gajim.org/gajim-plugins/ .</pre>
## (at next times) Update plugins to newer versions: ''hg pull''
+
## (at next times) Update plugins to newer versions: <pre>$ hg pull; hg up; rm -f */*.pyo</pre>
# Start gajim;
+
# [Re]Start gajim;
 +
 
 +
== Configuration ==
 +
At first time, you also need to activate OTR plugin:
 
# Go to menu Edit => Modules;
 
# Go to menu Edit => Modules;
# Activate the "Off-the-record encryption" plugin
+
# Activate the "Off-the-record encryption" plugin;
# (at first time) Click on plugin tweaking button, and generate your OTR key in gotr dialog.
+
# Click on plugin settings button;
# close dialogs to save the changes.
+
# Generate your OTR key using "Generate key";
 +
# Take a look on other settings;
 +
# Close dialogs to save the changes.
  
== gajim <= 0.13 ==
+
== Troubleshooting ==
  
Note: [http://hg.gajim.org/gajim/shortlog/c43a1b01d54d gajim's otr-branch] is unmaintained and obsoleted by gajim's plugin system (read above).
+
'''Q''': "Off-the-record encryption" is not shown in ''Modules''.
  
You can use [http://aur.archlinux.org/packages.php?ID=38813 aur:gajim-otr-hg] PKGBUILD to build OTR-compatible 0.13 version of gajim. Main issues are:
+
'''A''': Be sure, that ''~/.local/share/gajim/plugins/gotr/'' is not empty and '''python-potr''' installed on latest version.
  
* Received otr-encrypted messages with HTML markup will be rendered raw, unformatted, with HTML tags;
+
'''Q''': There are no ''Modules'' item in gajim menu.
  
The OTR setting will be located in the last tab of gajim parameters (Ctrl+P) -> Off-the-record encryption.
+
'''A''': Go to Help => About. The gajim version should be 0.15 or something like 0.14.0.1-b9cb32f5badd, where "b9cb32f5badd" is any commit id, if gajim-hg is used. If not, update gajim as said earlier.

Revision as of 03:10, 28 November 2012


OTR (off-the-record) encryption is strong end-to-end encryption protocol for instant messaging (read more). OTR hasn't any XMPP XEP, because OTR is of cross-protocol nature.

And Gajim is a powerful XMPP-client without OTR support out-of-the-box.

Gajim >= 0.15 (or gajim-hg)

Since version 0.15, Gajim has powerful plugin system. The gotr plugin is used to provide OTR encryption, and it depends on python-potr, the modern OTR protocol implementation written on python by Kjell Bradden.

Installation

To install the plugin follow these simple steps:

  1. Install aur:pure-python-otr-git;
  2. Install/update the gajim plugins from hg.
    1. To go through next steps, you need mercurial (a popular DVCS) installed:
      $ sudo pacman -S mercurial
    2. Go to gajim plugins directory:
      $ mkdir -p ~/.local/share/gajim/plugins/; cd ~/.local/share/gajim/plugins/
    3. (at first time) Download all plugins:
      $ hg clone http://hg.gajim.org/gajim-plugins/ .
    4. (at next times) Update plugins to newer versions:
      $ hg pull; hg up; rm -f */*.pyo
  3. [Re]Start gajim;

Configuration

At first time, you also need to activate OTR plugin:

  1. Go to menu Edit => Modules;
  2. Activate the "Off-the-record encryption" plugin;
  3. Click on plugin settings button;
  4. Generate your OTR key using "Generate key";
  5. Take a look on other settings;
  6. Close dialogs to save the changes.

Troubleshooting

Q: "Off-the-record encryption" is not shown in Modules.

A: Be sure, that ~/.local/share/gajim/plugins/gotr/ is not empty and python-potr installed on latest version.

Q: There are no Modules item in gajim menu.

A: Go to Help => About. The gajim version should be 0.15 or something like 0.14.0.1-b9cb32f5badd, where "b9cb32f5badd" is any commit id, if gajim-hg is used. If not, update gajim as said earlier.