- OMEMO Plugin for Gajim
- Installation
- Running
- Verification QR Codes
- Groupchat
- File transfer
- Debugging
- I found a bug
- Contact
- Changelog
OMEMO Plugin for Gajim
This plugin adds support for the OMEMO Encryption to Gajim. The OMEMO Plugin is free software distributed under the GNU General Public License version 3 or any later version.
Installation
Windows
Download the plugin via Gajims Plugin Manager.
MacOS
pip3 install --upgrade cryptography axolotl qrcode
afterwards download the plugin via Gajims Plugin Manager.
Linux
Arch
See AUR package.
Debian & Ubuntu
The package gajim-omemo
is available in backports, testing, and universe repos.
Use sudo apt-get install gajim-omemo
to install the plugin.
Gentoo
Use layman -a flow && emerge gajim-omemo
to install the plugin.
Fedora
Tested on Fedora 25
Enable copr repository:
dnf copr enable philfry/gajim
For Gajim 1.0:
dnf install python3-axolotl python3-axolotl-curve25519 python3-qrcode
Distributions without a package
Install the plugin with Gajims Plugin Manager. You need Gajim 1.0.0 or higher. If your package manager does not provide an up to date version you can visit gajim.org for further install instructions.
- Check if you have Gajim 1.0.0 or higher installed
sudo apt-get install build-essential libssl-dev libffi-dev python3-dev
sudo apt-get install python3-setuptools
sudo apt-get install python3-cryptography
sudo apt-get install python3-axolotl
- Restart Gajim, and activate OMEMO in Gajims Plugin Manager
Running
Enable the OMEMO plugin in the Plugin Manager. If your contact supports OMEMO, you should be able to activate it using the lock icon in the lower right of your chat window.
When you send your first message, the plugin will query your contacts encryption keys and you will see them in a readable fingerprint format in the fingerprint window which pops up. You have to trust at least one fingerprint to be able to send messages. You can receive messages from fingerprints where you didn't make a trust decision, but you can't receive Messages from not trusted fingerprints.
Verification QR Codes
It is possible to show a QR Code for verification in the plugin's configuration window.
You have to install the python3-qrcode
packages for QR Codes to work (Debian, Ubuntu).
If you want to use PIP for installing python packages, qrcode
and pillow
packages have to be installed.
Groupchat
Groupchat with OMEMO encryption works only in rooms that are:
- non-anonymous
- members-only
- works only with contacts that you have in your roster
File transfer
If your server supports http_upload (See ServerInfo Window) your file transfers are encrypted. P2P file transfers via Jingle are not encrypted
For decrypting and showing pictures in the chat window use the UrlImagePreview plugin.
Debugging
To see OMEMO related debug output, start Gajim with the following parameters:
-l gajim.plugin_system.omemo=DEBUG
I found a bug
Please report it to the issue tracker. If you are experiencing misbehaviour, please provide detailed steps to reproduce this and provide debugging output. Also, please always mention the exact Gajim version you are using.
Contact
You can contact us at gajim@conference.gajim.org.
Changelog
What changed in which Version? Have a look at the Changelog.