Gajim

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

Installation

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 window manager, you can use the following command:

$ gajim-remote toggle_roster_appearance

It may be necessary to restart Gajim if this does not 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.

In order to use OMEMO in Gajim, follow these steps:

1. Install the python-axolotl and python-qrcode packages.
2. Open Gajim and go to menu Gajim => Plugins;
3. Go to the Available tab;
4. Mark the "OMEMO" plugin and click the Install/Update Plugin button;
5. Go back to the Installed tab;
6. Activate the "OMEMO" plugin;
7. Close dialogs to save the changes;
8. Restart Gajim;
9. Please refer to the official documentation for running instructions

Notification sounds

Gajim requires gsound in order to play notification sounds.

Audio/Video Call Support

To use Gajim's Audio / Video Call feature farstream, gstreamer, gst-plugins-base, gst-plugins-ugly, gst-libav and gtk3 are required.

Advanced configuration

Settings in Preferences > Advanced > Advanced Configuration Editor can be adjusted in order to increase Gajim's usability.

Minimize / Close to tray

By default Gajim remains in the taskbar (for Docks) instead of minimizing to tray when closing it, to disable this behavior enable the hide_on_roster_x_button preference.

Hide chat banner

To hide the avatar banner that normally resides close to top of the two-person chat window enable the hide_chat_banner preference.

Save History of Messages

If the Save of Message History is enabled, a file ~/.local/share/gajim/logs.db is created. This is a SQLite database. (Open it with DB Browser for SQLite, install sqlitebrowser) To look for a message, first get the jid_id of the contact in table jids. Click on Tab "Search Data". Choose Table jids. Now click the tab "Run SQL" and run the statement

SELECT time, kind, message FROM logs WHERE jid_id=(the jid_id from table jids) ORDER BY time ASC;

and click the run button. The result ist a list of your messages orderd by time (first message first, latest message at the bottom). The column kind shows if the message was sent (Code: 6) or received (Code: 4).