|
|
# OMEMO Plugin for Gajim
|
|
|
|
|
|
This Plugin adds support for the [OMEMO Encryption](http://conversations.im/omemo) to Gajim. The OMEMO Plugin is [free software](http://www.gnu.org/philosophy/free-sw.en.html)
|
|
|
This plugin adds support for the [OMEMO Encryption](http://conversations.im/omemo) to Gajim. The OMEMO Plugin is [free software](http://www.gnu.org/philosophy/free-sw.en.html)
|
|
|
distributed under the GNU General Public License version 3 or any later version.
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
### Windows
|
|
|
|
|
|
Download the Plugin via Gajims Plugin Manager.
|
|
|
Download the plugin via Gajims Plugin Manager.
|
|
|
|
|
|
|
|
|
### Linux
|
... | ... | @@ -28,29 +28,25 @@ Use `layman -a flow && emerge gajim-omemo` to install the plugin. |
|
|
|
|
|
**Fedora**
|
|
|
|
|
|
*Tested on Fedora 25.*
|
|
|
*Tested on Fedora 25*
|
|
|
|
|
|
Add this snippet to `/etc/yum.repos.d/ux.repo`:
|
|
|
Enable copr repository:
|
|
|
|
|
|
```
|
|
|
[ux]
|
|
|
name=Unixadm.org - Fedora $releasever base repository
|
|
|
baseurl=http://reposerv.unixadm.org/fedora/$releasever/$basearch/
|
|
|
enabled=1
|
|
|
includepkgs=python3-axolotl python3-axolotl-curve25519
|
|
|
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-UNIXADM
|
|
|
gpgcheck=1
|
|
|
```
|
|
|
`dnf copr enable philfry/gajim`
|
|
|
|
|
|
*Optional:* Fetch the gpg key and save it to `/etc/pki/rpm-gpg/RPM-GPG-KEY-UNIXADM` (or else, set gpgcheck to 0).
|
|
|
For Gajim 1.0:
|
|
|
|
|
|
`dnf install python3-axolotl python3-axolotl-curve25519 python3-qrcode`
|
|
|
|
|
|
For Gajim 0.16:
|
|
|
|
|
|
`dnf install python2-axolotl python2-axolotl-curve25519 python2-qrcode`
|
|
|
|
|
|
`wget -O /etc/pki/rpm-gpg/RPM-GPG-KEY-UNIXADM https://www.unixadm.org/RPM-GPG-KEY-UNIXADM.asc`
|
|
|
|
|
|
`dnf install python3-axolotl python3-axolotl-curve25519 protobuf3-python`
|
|
|
|
|
|
### Distributions without a package
|
|
|
|
|
|
Install the Plugin with the Gajim PluginManager. 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](https://gajim.org/) for further install instructions.
|
|
|
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](https://gajim.org/) for further install instructions.
|
|
|
|
|
|
|
|
|
1. Check if you have Gajim 1.0.0 or higher installed
|
... | ... | @@ -63,17 +59,17 @@ Install the Plugin with the Gajim PluginManager. You need **Gajim 1.0.0** or hig |
|
|
|
|
|
## 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.
|
|
|
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
|
|
|
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 Verification Code](https://en.wikipedia.org/wiki/QR_code) in the Plugin's Config Window.
|
|
|
It is possible to show a [QR Verification Code](https://en.wikipedia.org/wiki/QR_code) in the plugin's configuration window.
|
|
|
|
|
|
You have to install the `python3-qrcode` packages for it to work (Debian, Ubuntu).
|
|
|
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.
|
|
|
|
... | ... | @@ -88,23 +84,21 @@ Groupchat with OMEMO encryption works only in rooms that are: |
|
|
|
|
|
## File transfer
|
|
|
|
|
|
If your server supports httpupload (See ServerInfo Window) your filetransfers are encrypted.
|
|
|
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 [UrlImagePreviewPlugin](./UrlImagePreviewPlugin) plugin.
|
|
|
For decrypting and showing pictures in the chat window use the [UrlImagePreview](./UrlImagePreviewPlugin) plugin.
|
|
|
|
|
|
|
|
|
## Debugging
|
|
|
|
|
|
To see OMEMO related debug output, start Gajim with the parameter:
|
|
|
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](https://dev.gajim.org/gajim/gajim-plugins/issues). 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.
|
|
|
Please report it to the [issue tracker](https://dev.gajim.org/gajim/gajim-plugins/issues). 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](xmpp:gajim@conference.gajim.org?join).
|
... | ... | |