Difference between revisions of "Gajim"

From ArchWiki
Jump to: navigation, search
(Installation: rm -f *.pyo)
(http -> https://aur.archlinux.org)
Line 14: Line 14:
 
To install the plugin follow these simple steps:
 
To install the plugin follow these simple steps:
  
# Install/update to lastest version of Gajim. Be sure, that version >= 0.15. If 0.15 version is not available, install [http://aur.archlinux.org/packages.php?ID=27152 aur:gajim-hg];
+
# Install/update to lastest version of Gajim. Be sure, that version >= 0.15. If 0.15 version is not available, install [https://aur.archlinux.org/packages.php?ID=27152 aur:gajim-hg];
# Install [http://aur.archlinux.org/packages.php?ID=56560 aur:pure-python-otr-git];
+
# Install [https://aur.archlinux.org/packages.php?ID=56560 aur:pure-python-otr-git];
 
# Install/update the gajim plugins from hg.
 
# Install/update the gajim plugins from hg.
 
## To go through next steps, you need mercurial (a popular DVCS) installed: <pre>$ sudo pacman -S mercurial</pre>
 
## To go through next steps, you need mercurial (a popular DVCS) installed: <pre>$ sudo pacman -S mercurial</pre>
Line 43: Line 43:
 
Note: [http://hg.gajim.org/gajim/shortlog/c43a1b01d54d gajim's otr-branch] is unmaintained and obsoleted by gajim's plugin system (read above).
 
Note: [http://hg.gajim.org/gajim/shortlog/c43a1b01d54d gajim's otr-branch] is unmaintained and obsoleted by gajim's plugin system (read above).
  
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:  
+
You can use [https://aur.archlinux.org/packages.php?ID=38813 aur:gajim-otr-hg] PKGBUILD to build OTR-compatible 0.13 version of gajim. Main issues are:  
  
 
* Received otr-encrypted messages with HTML markup will be rendered raw, unformatted, with HTML tags;
 
* Received otr-encrypted messages with HTML markup will be rendered raw, unformatted, with HTML tags;
  
 
The OTR setting will be located in the last tab of gajim parameters (Ctrl+P) -> Off-the-record encryption. At first time, you need to generate own key on this tab using "Generate" button (this will take some time).
 
The OTR setting will be located in the last tab of gajim parameters (Ctrl+P) -> Off-the-record encryption. At first time, you need to generate own key on this tab using "Generate" button (this will take some time).

Revision as of 19:01, 24 March 2012

Gajim and OTR

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/update to lastest version of Gajim. Be sure, that version >= 0.15. If 0.15 version is not available, install aur:gajim-hg;
  2. Install aur:pure-python-otr-git;
  3. 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
  4. [Re]Start gajim;

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.

Gajim <= 0.13

Note: gajim's otr-branch is unmaintained and obsoleted by gajim's plugin system (read above).

You can use aur:gajim-otr-hg PKGBUILD to build OTR-compatible 0.13 version of gajim. Main issues are:

  • Received otr-encrypted messages with HTML markup will be rendered raw, unformatted, with HTML tags;

The OTR setting will be located in the last tab of gajim parameters (Ctrl+P) -> Off-the-record encryption. At first time, you need to generate own key on this tab using "Generate" button (this will take some time).