# Gajim

This article is a stub.

Notes: please use the first argument of the template to provide more detailed indications. (Discuss in Talk:Gajim#)

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

## Installation

Install the gajim package.

## Auto logout on suspend

If you suspend your computer gajim stays connected for about 15 minutes. To prevent message loss, it is needed to set your status offline before suspending or hibernating. The status message won't be changed.

Therefore create a new systemd unit `gajim-suspend@.service`:

    /etc/systemd/system/gajim-suspend@.service

    [Unit]
    Description=Suspend Gajim
    Before=sleep.target
    StopWhenUnneeded=yes

    [Service]
    Type=oneshot
    User=%I
    RemainAfterExit=yes
    Environment=DISPLAY=:0
    ExecStart=-/usr/bin/bash -c ". /home/%I/.dbus/session-bus/$(</var/lib/dbus/machine-id)-0 && /usr/bin/gajim-remote change_status offline"
    ExecStop=/usr/bin/bash -c ". /home/%I/.dbus/session-bus/$(</var/lib/dbus/machine-id)-0 && /usr/bin/gajim-remote change_status online"

    [Install]
    WantedBy=sleep.target

Then enable the service.

## 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 doesn not support OTR out of the box.

Install the gajim-plugin-otrAUR package.

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

Category:

- Internet applications