From ArchWiki
Revision as of 18:32, 27 August 2018 by Stevenroose (talk | contribs) (OMEMO is the new standard for encryption, OTR is old and less relevant.)
Jump to navigation Jump to search

Gajim is a full featured and easy to use XMPP client.


Install the gajim package.

D-Bus remote control

To enable D-Bus remote control support, go to Preferences > Advanced > Advanced Configuration Editor, open the 'Advanced Configuration Editor', enable remote_control, and then restart Gajim.

Show/hide roster

If you would like to be able to show/hide the roster using a script or your wm, you can use the following command from the terminal.

$ gajim-remote toggle_roster_appearance

It may be necessary to restart Gajim if this doesn't work.

OMEMO Support

OMEMO Multi-End Message and Object Encryption is an XMPP Extension Protocol (XEP) for secure multi-client end-to-end encryption. It is an open standard based on Axolotl and PEP which can be freely used and implemented by anyone and recently got an experimental plugin for Gajim.

In order to use OMEMO in Gajim, just install the gajim-plugin-omemoAUR package which will also install all the required dependencies. Alternatively, you can install it from Gajim Plugin Manager after installing the dependencies of gajim-plugin-omemoAUR.


After installing the OMEMO plugin, you have to enable it in Gajim Plugin Manager in order to use it:

  1. Go to menu Edit => Plugins;
  2. Activate the "OMEMO Multi-End Message and Object Encryption" plugin;
  3. Close dialogs to save the changes.
  4. Restart Gajim.
  5. Please refer to the official documentation for running instructions

Off-the-Record Messaging

OTR (off-the-record) messaging 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. Gajim does not support OTR out of the box.

Installation / Configuration

  1. Go to "contact-window" menu "Edit => Plugins";
  2. If not activated out of the box, activate the "Plugin Installer";
  3. Restart Gajim.
  4. In "plugins-window", switch to the "Available" tab;
  5. Activate the "Off-the-record encryption" plugin;
  6. Restart Gajim.
  7. Click on plugin settings button;
  8. Generate your OTR key using "Generate key";
  9. Take a look on other settings;
  10. Close dialogs to save the changes.
  11. Restart Gajim.

gajim-otr version confusions

There are two differently developed/deployed versions of gajim-otr. One was developed at github but soon got merged into gajim's own plugin-repository. This repository is used for the development of many plugins, those plugins then get installed via. "Plugin Installer" from at the "view => plugins menu". github/gajim-otr shall not be used, due the fact it's source is outdated and not maintained.