Gajim - ArchWiki

Jump to content
From ArchWiki

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

## Installation

Install the gajim package for the latest stable version, and gajim-gitAUR to install the development version.

Note: Gajim updated python version, preventing a simple version bump for the stable package. As of 2023-02, use the gajim-gitAUR package if needed.

## 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

This article or section is out of date.

Reason: This no longer works. It seems that this command is deprecated (Discuss in Talk:Gajim)

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).

Category:

- XMPP

Hidden category:

- Pages or sections flagged with Template:Out of date