Mercurial > libervia-backend
view doc/jp/avatar.rst @ 3104:118d91c932a7
plugin XEP-0384: OMEMO for MUC implementation:
- encryption is now allowed for group chats
- when an encryption is requested for a MUC, real jids or all occupants are used to
encrypt the message
- a cache for plain text message sent to MUC is used, because for security reason we can't
encrypt message for our own device with OMEMO (that would prevent ratchet and break the
prefect forward secrecy). Thus, message sent in MUC are cached for 5 min, and the
decrypted version is used when found. We don't send immediately the plain text message
to frontends and history because we want to keep the same MUC behaviour as for plain
text, and receiving a message means that it was received and sent back by MUC service
- <origin-id> is used to identify messages sent by our device
- a feedback_jid is now use to use correct entity for feedback message in case of problem:
with a room we have to send feedback message to the room and not the the emitter
- encryptMessage now only accepts list in the renamed "entity_bare_jids" argument
author | Goffi <goffi@goffi.org> |
---|---|
date | Mon, 30 Dec 2019 20:59:46 +0100 |
parents | 72583524cfd3 |
children | 6cf4bd6972c2 |
line wrap: on
line source
=============================== avatar: retrieve/upload avatars =============================== Avatars are images associated to an XMPP entity. Several XMPP extensions are in use, SàT tries to hide the technical details so avatar are as easy as possible to manipulate for end-user. get === Retrieve the avatar of the given entity. Entity jid is specified as positional argument. If an avatar is found, a path to its cached file is printed. Please note that this is the cache used by all SàT ecosystem, **do not modify the cached image**. You may use it for read-only access, or copy it if you want to modify the image. You may use the ``-s, --show`` argument to display the found avatar. The software used to display the image can be specified in SàT configuration (cf. :ref:`configuration`), in the ``[jp]`` section: the ``image_cmd`` setting let you specify the path to the software. If ``image_cmd`` is not used, ``jp`` will try some common software, and if none is found, it will try to open the image in a browser (which may sometimes result in using the default image software of the platform). example ------- Get the avatar of ``louise@example.org`` and display it:: $ jp avatar get --show louise@example.org set === Upload and set the given avatar for the profile. The only required argument is the path to the image to use as avatar. example ------- Set the avatar of the default profile:: $ jp avatar set ~/photos/some_photo.jpg