Guides

Guide

Devices

Each iPhone, iPad or Mac running Whispurr is a device. Link your devices to the same account so your personas and chats are on all of them.

What a device is

A device is one installation of Whispurr. The first page you see, the device home, shows its name and its Device code: four words, such as amber-fern-basket-tide, that help you tell your devices apart. If you delete the app and install it again, that's a new device.

A device holds one or more accounts, but only one is open at a time. Device settings, such as theme and transports, belong to the installation, so every account on it uses them.

Primary and linked accounts

The device home lists the accounts on this device in two groups.

GroupWhat's in it
AccountsThe Primary Account, which Whispurr created on this device the first time you opened it.
Linked AccountsAccounts from your other devices, added with Link Account or Restore Account.

The open account is marked Current account. Tap it to go to its personas. Tap any other account to see its Account Details, then tap Switch to This Account. Each account keeps its own personas and chats, and nothing crosses between them. See Switch accounts.

Linking gives a new device access to an account you already use. It receives the account's personas, chats and activity history, and keeps them in sync from then on. Its own primary account stays on it.

Linking a device: your iPhone scans the code your Mac shows, both show the same verification code, you approve, and the account's history is sent across. Has the account Approve Device scans the code New device QR Link Account 1 · Scan one device's code with the other 3F9A21C7 2 · Check both show the same code 3 · Approve · history is sent
You approve every new device from one you already trust, after checking that both show the same verification code.
  1. On the new device, go to the device home and, under Linked Accounts, tap Link Account.
  2. On a device that already has the account, open the account and, under Approved Devices, tap Approve Device. On a Mac, Approved Devices is in Account Settings.
  3. Connect the two. One device shows a QR code and the other reads it. A Mac shows its code by default and an iPhone or iPad scans, whichever one has the account. Use the switch at the top to change this:
    • Two iPhones or iPads: choose Show Code on one and Scan Code on the other.
    • Two Macs: click Copy Code (or Copy Invitation) on one and send it to the other Mac. On the other, choose Enter Code, paste it and click Use Code. Choose QR Image reads a screenshot of the code instead.
  4. The device that has the account asks Approve followed by the new device's name, and shows a verification code. Check that the new device shows the same code, then tap Approve Device.
  5. A progress bar shows the account and chat history being sent. Then both devices show a second code. Check that they match.
  6. On the new device, tap Link Account and Switch. The device that approved it shows Device approved.

Never approve a device whose code doesn't match: someone else may have seen your code. If the new device shows a different code, or none, don't link. Codes refresh on their own. Linking never sends your recovery phrase to the new device.

Linking also passes on your Vault, if the approving device has opened it. A device that didn't get the Vault can open it later with your recovery phrase. See The Vault and your phrase.

Link a server

A server running Whispurr has no screen. Approve it the same way, then answer y in the server's terminal to finish linking. A server can then act as a backup device.

Approved devices

Approved Devices lists every other device that uses this account. On iPhone and iPad it's on the account page, under your personas. On a Mac it's in Account Settings. Each row shows whether the device is a Backup device, when it was last seen, and Needs update if the two devices run versions of Whispurr that can't sync.

Tap a device to see its details:

Remove a device

  1. Tap the device, then tap Remove Device.
  2. Choose Remove if you still have the device or have erased it. Choose Remove and Replace Recovery Phrase if it's lost or you no longer trust it. A backup device always replaces the phrase.
  3. If the phrase was replaced, write down the new 24 words and tap I’ve Recorded It. Your old phrase stops working.

Removing a device stops the account syncing with it. It doesn't erase anything already stored on that device, and its own primary account stays there. If you still have it, use Leave Account on it too. More in Lost devices.

Leave an account

Leaving takes a linked account off this device. The device returns to its primary account, and your other devices keep their access.

  1. Make sure the linked account is the one open.
  2. Open Account Settings and tap Leave Account.
  3. Confirm with Leave Account.

You can also leave from the account's Approved Devices: tap the device that approved this one and choose Leave Account. That device is told you left. You can't leave a device's primary account. To remove that one, see Delete Account.

Reset the app

Device Settings › Reset App deletes data from this device. What it deletes depends on which account is open:

Copies on your other devices are kept. If this was the account's only active device, Whispurr also asks Courier to erase the account's stored messages. If that can't finish, the data expires on its own. See Courier.

Before you reset, record your recovery phrase. With it, you can restore the account from one of its backup devices. Without a backup device or another linked device, a reset can't be undone.

Settings

One settings screen covers every level of Whispurr. A switcher at the top shows the level you opened it from and every level that contains it: Device, Account, Persona, Chat, Thread and Route. Opened from a chat, for example, it offers Device, Account, Persona and Chat. Opened from the device home, it offers Device and Account.

Device Settings apply only to this installation.

SettingWhat it doesDefault
Device Code, Device IDThis device's four-word code and full identifier. Tap to copy.—
RenameNames this device, up to 100 characters. The name is stored on this device.The system's device name
ThemeSystem, Light or Dark.System
Generate link previewsWhen you paste a link, this device loads the page once to build a preview and sends it with your message. People you chat with never contact the site. Unavailable while Hide IP Address is on.On
Show map under routesDraws Apple Maps under recorded routes and shared locations. Apple sees the map area shown, never the route. Off draws them on a plain background and requests no maps.On
Live route updatesHow often a route shared live updates the chat while someone is watching it: every 2, 5 or 15 seconds, or every minute. Nothing is sent while nobody is watching. See Live rides.Every 5 s
Include photo locationsPhotos you send keep where they were taken, rounded to about 11 m, so they appear on the chat's map. Photos taken inside one of your privacy zones never include it.Off
Allow notificationsLets this device show notifications. Turning it on asks for the system's permission. See Notifications.Off
Show message previewsShows the start of a message in its notification. Previews are decrypted on your device. Needs Allow notifications.Off
NetworkConnects over the internet and local IP networks. See Transports.On
Nearby Wi-FiConnects directly to verified chat members nearby over Wi-Fi.Off
BluetoothConnects directly to verified chat members nearby over Bluetooth. Turning every transport off keeps chats on this device.Off
Hide IP AddressConnects to contacts over the internet only through a Whispurr relay, so they never learn your IP address. Reactions you add from other sites are downloaded through whispurr.app. Needs Network. See Hide IP Address.Off
AboutThe app version, with Replay Onboarding, Guides, Whispurr Homepage and Privacy Policy.—
Reset AppDeletes this device's data. See Reset the app.—