... | ... | @@ -8,7 +8,7 @@ This plugin adds support for the [OMEMO Encryption](http://conversations.im/omem |
|
|
|
|
|
### Windows
|
|
|
|
|
|
Download the plugin via Gajims Plugin Manager.
|
|
|
OMEMO is automatically installed on Windows.
|
|
|
|
|
|
### MacOS
|
|
|
|
... | ... | @@ -58,14 +58,12 @@ Install the plugin with Gajims Plugin Manager. You need **Gajim 1.3.0** or highe |
|
|
5. `sudo apt-get install python3-axolotl`
|
|
|
6. 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](https://en.wikipedia.org/wiki/QR_code) for verification in the plugin's configuration window.
|
... | ... | @@ -83,16 +81,11 @@ The concept of [Blind Trust Before Verification (BTBV)](https://gultsch.de/trust |
|
|
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](./UrlImagePreviewPlugin) plugin.
|
|
|
|
|
|
If your server supports HTTP File Upload (See ServerInfo Window) your file transfers are encrypted.
|
|
|
P2P file transfers via Jingle are **not** encrypted.
|
|
|
|
|
|
## Debugging
|
|
|
|
... | ... | @@ -102,6 +95,7 @@ To see OMEMO related debug output, start Gajim with the following parameters: |
|
|
|
|
|
|
|
|
## 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.
|
|
|
|
|
|
## Contact
|
... | ... | |