termchat.app

Devices

One identity can live on up to four devices, for example your phone and your laptop. Contacts see one person with one fingerprint, and their messages reach every device. Each device has keys of its own; the first one, your main device, vouches for the others (ADR-028).

  1. Install termchat.app on the new device and create an identity there: any nickname, it is replaced by your main one’s. Do not add contacts on it.
  2. On the new device, ask for a link code:
    • terminal: Ctrl+P, then l “link to my main device”;
    • desktop: Settings, Link to my main device;
    • Android: ⋮, Link to my main device.
  3. On your main device, open the devices and add it:
    • terminal: Ctrl+P, v, then a, and paste the code;
    • desktop: Settings, Devices…, Add a device;
    • Android: ⋮, Devices, then scan its QR code or paste the code.
  4. Both screens now show one fingerprint. Go on only if it is the same on both: someone who copied the link code would show another one. Confirm on both devices.
  5. The new device says “This device is linked”, takes your nickname and gets your contacts.

What moves over, and what does not

  • Your contacts move, with your names for them and their verified marks. Each device then talks to each contact on its own.
  • History does not. A new device starts with empty chats; older messages stay on the devices that have them.
  • Incognito contacts stay on the main device: each is an identity of its own.
  • Groups reach every device: accept an invite on one, and your other devices join too. New groups are made on the main device. If someone in a group runs an older version, it cannot read what your linked devices write there.
  • Documents reach every device of the contact. Your other devices show that you sent one, but the file itself stays on the device that sent it.

What you see on each device

  • Messages from a contact appear on every device.
  • What you send from one device appears on your other devices as yours.
  • A contact whose app is older than 0.12 hears only your main device. Writing to them from a linked device says they need to update first.

Labels, removing, losing a device

  • Labels, like “phone” or “laptop”, are set on the main device: in the device list, r in the terminal, Rename on the desktop and on Android. Only your own devices see them, never your contacts.
  • Removing a device: on the main device, in the device list, x in the terminal, Remove on the desktop and on Android. The removed device keeps what it already had, says so, and reads and sends nothing more. Contacts stop writing to it.
  • A lost linked device: remove it from the main one.
  • A lost main device: the linked devices keep working, but devices can no longer be added or removed. Restore the main device from its backup (Backups, locking, wiping); its sessions with contacts start anew.
  • The duress password wipes only the device it is typed on.

What others learn

  • Contacts see how many devices you have and their keys, never their labels.
  • The relay sees that a message to you is several writes at once, one per device, and can tie those queues together as one person’s devices. Without Tor, IP addresses tie your devices to each other too. It still cannot read anything. The threat model has the details.