Setup (Commands)

Sign up to an account somewhere.

1/connect bob@bobserver.org

Check if someone wants to be your friend:

1/sub received

Accept a friend's subscription request:

1/sub add alice@aliceserver.org

Join a room:

1/join room1@bobserver.org

Save your configuration so you don't have to do this again:

1/save

Check your ~/.config/profanity/profrc for how to data's saved.

Automatically Sign In

To automatically sign in, add your password to pass.

1/account set *malin@oosm.org* eval_password pass *xmpp*

1/autoconnect set *malin@oosm.org*

1/save

Remember to save the config for other commands too.

General Use

Messages

1/msg alice@aliceserver.org

This opens in a new tab. Switch tabs with alt+number.

Docs

The docs are massive, so it's often better to use:

1/help <Tab>

Editing

For long text, you can use vim:

1/executable editor set vim

1/editor

Sending & Receiving Files

Tell it how to save files:

1/executable urlsave set "wget %u -O %p"

Then get the file with:

1/urlsave *<Tab>*

Same for /urlopen

Theme

1profanity

1/theme list

1theme load batman

Encryption

omemo

1/omemo gen

1/omemo start

You can accept everyone's fingerprint all the time with

1/omemo trustmode firstusage

This will still encrypt, but there will be no check that you have the right person the first time you speak with someone.

You can ensure omemo automatcally turns on:

1/omemo policy automatic

'OTR' encryption is mostly dead, but you can find the old instructions here.