2019-12-23 01:12:07 +00:00
|
|
|
Poezio OMEMO plugin
|
|
|
|
|
###################
|
|
|
|
|
|
2020-02-21 17:52:39 +00:00
|
|
|
**This plugin will not work with Poezio 0.12.**
|
|
|
|
|
|
|
|
|
|
|
2019-12-23 01:12:07 +00:00
|
|
|
This is a `Poezio <https://poez.io>`_ plugin providing OMEMO support. It
|
|
|
|
|
distributed separately for licensing reasons.
|
|
|
|
|
|
2019-12-29 01:26:14 +00:00
|
|
|
This plugin is very much **alpha**. It handles encryption and decryption
|
|
|
|
|
of OMEMO messages, but doesn't display the encryption state of messages,
|
2020-02-16 15:34:41 +00:00
|
|
|
and neither does it have a way to do trust management. As this plugin is
|
|
|
|
|
still changing often, it is recommended that users follow experimental
|
|
|
|
|
(master) versions of this project and its dependencies.
|
2019-12-23 01:12:07 +00:00
|
|
|
|
|
|
|
|
License
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
This plugin is licensed under GPLv3.
|
|
|
|
|
|
|
|
|
|
Note on the underlying OMEMO library
|
|
|
|
|
------------------------------------
|
|
|
|
|
|
|
|
|
|
As stated in `python-xeddsa's
|
|
|
|
|
README <https://github.com/Syndace/python-xeddsa/blob/136b9f12c8286b9463566308963e70f090b60e50/README.md>`_,
|
|
|
|
|
(dependency of python-omemo), this library has not undergone any
|
|
|
|
|
security audits. If you have the knowledge, any help is welcome.
|
|
|
|
|
|
|
|
|
|
Please take this into consideration when using this library.
|
|
|
|
|
|
|
|
|
|
Installation
|
|
|
|
|
------------
|
|
|
|
|
|
2020-02-16 15:34:41 +00:00
|
|
|
As this plugin is still changing often, it is recommended that users
|
|
|
|
|
follow experimental (master) versions of this project and its
|
|
|
|
|
dependencies.
|
|
|
|
|
|
2019-12-23 01:12:07 +00:00
|
|
|
- ArchLinux (AUR):
|
|
|
|
|
`python-poezio-omemo <https://aur.archlinux.org/packages/python-poezio-omemo>`_, or
|
|
|
|
|
`python-poezio-omemo-git <https://aur.archlinux.org/packages/python-poezio-omemo-git>`_
|
|
|
|
|
- PIP: `poezio-omemo`
|
|
|
|
|
- Manual: `python3 setup.py install`
|
2020-02-16 15:34:41 +00:00
|
|
|
|
|
|
|
|
Use in poezio
|
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
Once installed (see the `Installation`_ section below), you can add
|
|
|
|
|
`omemo` in the `plugin_autoload` configuration. See the Poezio
|
|
|
|
|
`documentation
|
|
|
|
|
<https://doc.poez.io/plugins/index.html#plugin-autoload>`_ for more
|
|
|
|
|
information about autoloading plugins.
|
2020-03-13 01:27:58 +00:00
|
|
|
|
|
|
|
|
TODO
|
|
|
|
|
----
|
|
|
|
|
|
|
|
|
|
- MUC support. Needs support for handling MUC reflections in poezio first.
|
|
|
|
|
- aesgcm
|
