Messages
Sending
Type and send: Enter in the terminal and the desktop app (Shift+Enter there starts a new line), Send on Android. A message holds up to 16 000 bytes: about 16 000 Latin or 8 000 Cyrillic characters. Pasted text is only text; it never acts as key presses.
Next to your messages: … (terminal) or “sending” while it goes out, ✓ or “sent” once the relay has it, ✗ or “failed” with the reason.
If your contact is offline, the relay keeps the encrypted message for up to 14 days and hands it over when they come back.
Answers, edits, deletes, reactions
Since version 0.9, between apps that both run 0.9 or newer:
- Answer a particular message. The answer shows the first line of what it answers; it carries a pointer, not the text, so a disappearing message still disappears on time.
- Edit your own message. The other side sees the new text and an “edited” mark. No history is kept, and the timer of a disappearing message does not move.
- Delete your own message for both of you. A line “message deleted” stays. A delete is a request: a modified app, a screenshot or a backup on the other side keeps what it kept.
- React with one of seven signs: like, love, laugh, wow, sad, thanks, dislike. The same one again takes it back. One reaction each per message.
How:
- Terminal: Shift+↑ or Ctrl+N picks the newest message; ↑/↓ move. Then Enter answers, e edits, d deletes (after y), 1 to 7 react, Esc goes back to typing. While you answer or edit, the top of the field says so; Esc cancels.
- Desktop: right-click a message: the seven reactions on top, then Answer, and Edit and Delete for both… on your own. The line over the field says what SEND will do; a click on it or Esc cancels.
- Android: long press a message: the reactions, Answer and Copy, and Edit and Delete for both… on your own. × over the field cancels.
A contact on 0.8 or older cannot read these. Until their app says it can, yours sends them plain messages and offers no answers or reactions in that chat (“their app is older”). When you first update, contacts still on 0.8 see one “could not be decrypted” line and one “1 message lost”: nothing is lost in fact.
Documents
Files of up to 1 MiB, end-to-end encrypted like messages. 200 KB takes about 10 seconds, 1 MiB about 3 minutes. Files work only between accepted contacts.
- Send: Ctrl+L in the terminal (type the path), File in the desktop app, 📎 on Android.
- Receive: the file waits in the chat as “unsaved”. Ctrl+G in the terminal saves the newest one into a folder you type (
~/Downloadsby default; the folder must exist), or discards it if you typeDISCARD. The desktop app has Save… under it, Android Save and Discard.
termchat.app never opens, previews or renders a file, and never overwrites one when saving. Files from contacts can be harmful: check before you open them. A saved file lives outside termchat.app, and wiping does not erase it.
Disappearing messages and no history
- Disappearing messages (Ctrl+T in the terminal, the timer button next to the field in the apps): off → 5 minutes → 1 hour → 1 day → 1 week. It applies to what you send from then on, and the message disappears on both sides when its time is up. The chat title shows
⏱. - No history (Ctrl+E in the terminal, ⋮ → No history in the apps): this chat is never written to disk. It is gone when you lock or quit.
Search
Ctrl+S in the terminal, ⋮ → Search on Android. Results show as you type, newest first. Search runs on your device only. The desktop app has no search yet.
Warnings in a chat
- “⚠ N message(s) missing so far”: something sent to you did not arrive, lost or dropped by the relay. It goes away if the message turns up later.
- “⚠ they restarted the conversation”: your contact restored a backup or reinstalled. Messages sent around then may be lost; nothing else to do.