Settings and data
Opening settings
- Terminal: Ctrl+P, then s. Tab or a click switches tabs (theme, notifications, interface, security), ↑/↓ move, Enter or a click changes the value.
- Desktop: Settings under the contact list.
- Android: ⋮ → Settings.
The security settings (backup, passwords, Tor, bridges, connections, lock time, wipe) are described in Backups, locking, wiping and Tor and bridges.
Themes
19 colour themes, light and dark, the same in all three apps; the terminal adds terminal, its own 16 colours, for terminals without true colour. In the terminal, moving through the list shows each theme at once; the chat keeps your terminal’s background, and the theme colours the bars and windows.
Notifications
termchat.app never puts a name or a text where the operating system keeps them.
- Terminal: a card with the sender’s name (never the text) shows in the corner for 5 seconds when a message arrives in a chat you are not looking at; click it to open the chat. sound for new messages plays the system sound (macOS: Glass; Linux:
canberra-gtk-playorpaplay; otherwise the terminal bell). system notification (off by default) asks the terminal for a desktop notification that always says just “termchat: new message”. The window title shows only the unread count:termchat (3). - Desktop: the system sound for new messages, in Appearance.
- Android: see Android: “termchat: New message”, with no name and no text.
Mouse (terminal)
The interface tab turns the mouse on or off. While it is on, the terminal’s own text selection needs Shift held while dragging.
Where data lives
~/.termchat/state |
Everything about your identity: keys, contacts, history. One file, encrypted with your password. Windows: C:\Users\<you>\.termchat\state. |
~/.termchat/arti |
Tor’s directory cache, when Tor is on. |
~/.termchat/settings.json |
Theme, sound, mouse, lock time. Not encrypted, so that the lock screen can use your theme; it holds nothing about your contacts, and a wipe removes it. |
~/.termchat/lock |
Keeps a second program from opening the same account. |
The terminal client and the desktop app share this folder. Set TERMCHAT_HOME to keep a separate identity elsewhere, for example to try termchat.app with two identities on one computer:
TERMCHAT_HOME=~/termchat-test termchat
On Android everything lives in the app’s private storage.