If something goes wrong
| Problem | What to do |
|---|---|
Stuck on ○ connecting… |
Check your internet. With Tor the first connection can take up to a minute, through bridges a few minutes. If it never connects, Tor may be blocked where you are: add bridges. Or turn Tor off for a moment to see whether the relay is reachable at all. |
wrong password |
Passwords are case-sensitive and depend on the keyboard layout. There is no recovery; restore from a backup if you have one. |
SAVE FAILED in the status bar |
The disk is full or not writable. Messages are acknowledged only once they are saved, so nothing is lost; free some space. |
| “termchat.app is already open in another window” (in a script: “this identity is open in another termchat”) | The terminal client, the desktop app and the scriptable mode share one account, one at a time. Quit the other one, or wait for the other command to end. |
A contact shows ↻ or “needs a new invite” |
They were added before version 0.7.0. Exchange invites again. |
| “their app is older” | Answers and reactions need 0.9 on both sides; ask them to update. |
| c does not copy the invite | Your terminal does not let programs use the clipboard (OSC 52; macOS Terminal does not). Select the text with the mouse while holding Shift. |
| The layout looks broken | Make the window larger, at least 80×24, and use a font with box-drawing characters. In an old terminal without true colour pick the terminal theme. |
| Selecting text with the mouse does not work | Hold Shift while dragging, or turn the mouse off in settings → interface. |
| No sound | macOS plays a system sound; Linux needs canberra-gtk-play or paplay; otherwise the terminal bell is used, which your terminal may mute. |
termchat add from a script ends with code 4 |
The request goes with the next command; run any command again, or termchat contacts. |
Something else? Open an issue at github.com/prophecy1345/termchat/issues. Never paste your password, backup or invite there.