+++ Sunday 26 January 2025 +++


Sending and receiving files with Profanity using OMEMO
======================================================

Profanity is a TUI Jabber client.
It advertises itself as:

   "Profanity is a console based XMPP client written in C using
   ncurses and libstrophe, inspired by Irssi".

Profanity is easy and intuitive to use, and is using up to date
libraries. Profanity can also be used to participate in Jabber chat
rooms.

End-to-end encryption
---------------------
Jabber is a great instant messaging protocol. It supports the
enhancement of the privacy of your chats with encryption.

Depending on the client you can choose between several encryption
methods. The clients at both sides (your client as well as the client
of the person you are chatting with) have to support the use of the
choosen encryption method.

Profanity supports several methods for end-to-end encryption:
* OTR: off the record encryption
* OpenPGP: encryption with GnuPG
* OMEMO: encryption using OMEMO

OMEMO is a watered down version of the encryption method used by
Signal. When you want to use OMEMO, first check that the provider for
your Jabber account supports OMEMO.

Using OMEMO
-----------
Before you can use OMEMO encryption you and the person you are
chatting with must first trust each others fingerprint.

See: https://profanity-im.github.io/guide/latest/omemo.html

After this start the encryption with /omemo start <jid>.
Look at the top bar, which should now state 'OMEMO'.

Sending files
.............
To send a file, use the command:

    /sendfile <path>

For example:

    /sendfile ~/cat.jpeg

The chat window will show a very long URL, starting with
aesgcm://

Receiving files
...............
When a file is send to you, the URL appears in your
chat window. To fetch and save this file, use the command:

    /url save <url> <path>

You don't have to manually copy the URL, just hit the TAB key.
This means, that you type the following:

   /url save TAB <path>

Where <path> is the path to a directory to save the file,
for example:

   /url save TAB /tmp

to fetch and save the file into the /tmp directory.


Last edited: $Date: 2025/01/26 21:47:23 $