lk/chat/profanity.md

194 lines
2.2 KiB
Markdown
Raw Normal View History

2022-01-16 18:20:39 +00:00
---
title: "profanity"
2022-01-26 21:29:48 +00:00
tags: [ "Documentation", "Chat" ]
2022-01-16 18:20:39 +00:00
---
2022-11-23 21:45:29 +00:00
# Setup (Commands)
2020-01-02 00:04:35 +00:00
Sign up to an account somewhere.
```
/connect bob@bobserver.org
```
2020-08-02 18:15:58 +00:00
Check if someone wants to be your friend:
```
/sub received
```
2020-08-02 18:15:58 +00:00
Accept a friend's subscription request:
```
/sub add alice@aliceserver.org
```
2020-08-02 18:15:58 +00:00
Join a room:
```
/join room1@bobserver.org
```
2020-08-02 18:15:58 +00:00
2022-11-23 21:45:29 +00:00
Save your configuration so you don't have to do this again:
```
/save
```
2022-11-23 21:45:29 +00:00
Check your `~/.config/profanity/profrc` for how to data's saved.
## Automatically Sign In
To automatically sign in, add your password to [pass](../data/pass.md).
```
/account set *malin@oosm.org* eval_password pass *xmpp*
```
2022-11-23 21:45:29 +00:00
```
/autoconnect set *malin@oosm.org*
```
2022-11-23 21:45:29 +00:00
```
/save
```
2022-11-23 21:45:29 +00:00
Remember to save the config for other commands too.
# General Use
## Messages
```
/msg alice@aliceserver.org
```
2022-11-23 21:45:29 +00:00
This opens in a new tab.
Switch tabs with alt+number.
## Docs
The [docs](https://profanity-im.github.io/guide/0131/reference.html) are massive, so it's often better to use:
```
/help <Tab>
```
2022-11-23 21:45:29 +00:00
## Editing
For long text, you can use vim:
```
/executable editor set vim
```
2022-11-23 21:45:29 +00:00
```
/editor
```
2022-11-23 21:45:29 +00:00
## Sending & Receiving Files
Tell it how to save files:
```
/executable urlsave set "wget %u -O %p"
```
2022-11-23 21:45:29 +00:00
Then get the file with:
```
/urlsave *<Tab>*
```
2022-11-23 21:45:29 +00:00
Same for `/urlopen`
## Theme
2020-01-02 00:04:35 +00:00
```
profanity
```
2020-01-02 00:04:35 +00:00
```
/theme list
```
2020-01-02 00:04:35 +00:00
```
theme load batman
```
2020-01-02 00:04:35 +00:00
2022-11-23 21:45:29 +00:00
# Encryption
## omemo
2020-02-01 18:40:02 +00:00
```
/omemo gen
```
2020-02-01 18:40:02 +00:00
```
/omemo start
```
2020-02-01 18:40:02 +00:00
2022-11-23 21:45:29 +00:00
You can accept everyone's fingerprint all the time with
```
/omemo trustmode firstusage
```
2022-11-23 21:45:29 +00:00
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:
```
/omemo policy automatic
```
2022-11-23 21:45:29 +00:00
## otr
2020-01-02 00:04:35 +00:00
Install libotr-dev or libotr5-dev or whatever..
```
sudo apt -y install lib5otr-dev
```
2020-01-02 00:04:35 +00:00
Make your otr keys.
```
/otr gen
```
2020-01-02 00:04:35 +00:00
Then you can start an otr converstation.
```
/otr start bob@jobbies.org
```
2020-01-02 00:04:35 +00:00
2022-11-23 21:45:29 +00:00
Or if you already have a conversation windows open, switch to our using:
2020-01-02 00:04:35 +00:00
```
/otr
```
2020-01-02 00:04:35 +00:00
Finally, verify!
```
/otr question "Who are you?" bob
```
2020-01-02 00:04:35 +00:00
Bob is verified upon the answer, 'bob'.
2022-11-23 21:45:29 +00:00
### OTR Finger Prints
2020-01-02 00:04:35 +00:00
Get yours with
```
/otr myfp
```
2020-01-02 00:04:35 +00:00
```
/otr theirfp
```
2020-01-02 00:04:35 +00:00
```
/otr myfp
```
2020-01-02 00:04:35 +00:00