Terminal
termchat runs in any terminal window. Use the keyboard or the mouse. ? or F1 lists the keys at any time; Ctrl+P opens the menu, which also holds a manual.
The screen
contacts │ alice·36335 ! not verified (Ctrl+F)
│
! alice·36335 │ alice·36335 2m
● bob 2 │ hi!
? carol·58121 │
│ you now
│ hello ✓
│
│ › message
+ add ≡ menu │
● online you ! no backup: Ctrl+P ^P menu ? keys ^K lock ^Q quit
- Left: contacts, the most recent chat on top. Click one, or use ↑/↓. The number on the right counts unread messages. Drag the line between the list and the chat to resize it. In a narrow window the list hides; ↑/↓ still switch chats.
- Right: the chat. Messages are grouped under the sender’s name and their age (
now,2m,3h,4d). PgUp/PgDn or the mouse wheel scroll back;↓ PgDnshows you are not at the newest message. - Bottom: where you type. Long text wraps.
- Status bar:
● online,● online via Toror○ connecting…, your nickname, and warnings. The hints on the right can be clicked.
Marks
| Mark | Meaning |
|---|---|
● |
unread messages |
? |
a contact request you have not accepted |
! |
safety number not verified yet |
× |
blocked |
- |
the contact deleted their account |
↻ |
needs a new invite (from before anonymous queues) |
# |
a group; the number on the right counts its members |
alice·36335 |
name plus the start of the fingerprint: for unverified contacts, and whenever two names look the same |
… ✓ ✗ |
your message: sending, on the relay, failed |
▲ ♥ ☺ ◎ ☹ ✧ ▼ |
reactions: like, love, laugh, wow, sad, thanks, dislike |
Keys
| Key | Action |
|---|---|
| Enter | send |
| ↑ / ↓ | choose contact |
| PgUp / PgDn | scroll the chat |
| Shift+↑ or Ctrl+N | pick a message: Enter answer, e edit, d delete for both, 1–7 react (again to take back), Esc back |
| Ctrl+A | add a contact from an invite |
| Ctrl+O | your invite: c copy, p public, i incognito, r revoke unused |
| Ctrl+Y | accept a request |
| Ctrl+F | safety number: v marks verified |
| Ctrl+S | search this chat |
| Ctrl+T | disappearing messages: off, 5m, 1h, 1d, 1w |
| Ctrl+E | no history: this chat stays in memory only |
| Ctrl+L / Ctrl+G | send a file / save the newest received file |
| Ctrl+R | rename the contact |
| Ctrl+B | block / unblock |
| Ctrl+D | delete the contact, or reject a request |
| Ctrl+X | report to the relay operator |
| Ctrl+P | menu: s settings, k keys, m manual, n what’s new, o invite, a add, b backup, g new group, v devices, l link to my main device (a new device) |
| Ctrl+K | lock now |
| Ctrl+Q or Ctrl+C | quit |
| ? or F1 | the list of keys |
| Esc | close a window, cancel an answer or edit |
Editing what you type: ←/→, Home/End, Alt+←/→ (by word), Ctrl+W (delete a word), Ctrl+U (delete to the start).
Groups
A small private group of up to 32 people, by invitation only (ADR-027).
- New group: Ctrl+P, then g, and a name. You are its admin.
- Invite: in the group, Ctrl+R opens the members, a lists contacts you can invite. Only your own contacts, on a version that knows groups.
- Join: the invite comes in your chat with the admin; Ctrl+Y there joins.
- In the group: answers, edits, deletes and reactions work as in a chat. Each member’s name has a colour of its own, the same on every device. Only the admin sets the timer (Ctrl+T).
- Remove: Ctrl+R, pick the member, x. The group moves to a new queue; they read nothing from then on.
- Leave: Ctrl+D. The others are told; the chat stays with you, read-only.
A new member does not see what was said before they joined.
Mouse
Click a contact to open it; right-click it for everything you can do with it. Drag the edge of the contact list to resize it. While the mouse is on, the terminal’s own text selection needs Shift held while dragging (Option in some macOS terminals); or turn the mouse off in settings.