Guides

Guide

Backups and recovery

Whispurr keeps no copy of your account on its servers. Your backup is a Mac or a server of your own, and your 24-word recovery phrase lets you restore from it if you lose your other devices.

Restoring needs a backup device that is on and online. The recovery phrase is not a copy of your chats. If you only have an iPhone and lose it, the phrase alone can't bring your account back. Set up a backup device, or keep another device linked.

Recovery phrase

Each account has a recovery phrase of 24 words. With it, and one of your backup devices, you can restore the account on a new device. Write the words down and keep them somewhere safe and offline.

Only the device that made the phrase, or the one where you last typed it in, can show it. Linking a device never sends it.

Reveal and record the phrase

  1. Open Account Settings › Recovery Phrase.
  2. Tap Reveal Recovery Phrase and confirm with Face ID, Touch ID or your passcode.
  3. Write down the 24 numbered words in order, then tap Hide Recovery Phrase.

The words hide themselves when you leave the screen or switch apps. While they're showing, you can also:

Remove the phrase from this device

Once you've recorded the words, Remove Saved Phrase deletes this device's copy, so nobody can reveal, copy or show it here. The words you recorded still work. Copies elsewhere, such as screenshots, are kept.

Make a new phrase

Make New Recovery Phrase replaces the phrase. The old one stops working on every device, and this device becomes the only one that can show the new one. Your other devices tell you the phrase was replaced. Make it on a device that has opened your Vault, or the new phrase won't restore Vault items: see The Vault and your phrase.

Anyone with your phrase can ask your backup device to restore your account, but it still asks you to approve. Never share the phrase or keep it in a chat.

Backup devices

Every device linked to your account has a copy of it. A backup device goes further: it keeps a full copy of your chats, photos and files, and answers when you restore with your recovery phrase. It has to be a Mac or a server running Whispurr, because it needs to stay on. An account can have up to four.

Your phone syncs to a Mac backup device. If the phone is lost, a new phone enters the recovery phrase, you approve on the Mac, and the Mac sends the account back. Your phonelost Mac at homebackup device New phonerecovery phrase kept in sync you approve, it restores

Make this Mac a backup device

  1. Link the Mac to your account and open the account on it.
  2. Open Account Settings and, under This Mac, turn on Use This Mac as a Backup Device.
  3. Turn on Open Whispurr at Login, so backups carry on after a restart.
  4. Keep the Mac on, with Whispurr open, and set it not to sleep. Its progress shows as items copied.

Backup runs for the account that's open in Whispurr on the Mac. If the Mac backs up more than one account, the others wait until you open them.

Choose a backup device from another device

On any device, open Approved Devices, tap a Mac or server and turn on Use as Backup Device. Or open the backup status screen and choose it under Add Backup Device. A Mac or server has to be linked first.

The menu bar on a Mac

While a Mac is a backup device, Whispurr adds an icon to the menu bar, even with no window open. Click it to see This Mac is a backup device, how many items are copied, and any account that's paused while another is open. Open Whispurr brings the app forward.

A server as a backup device

A server running Whispurr can also be a backup device. You approve restores on the server itself with whispurrd restore approve. A server is never given your Vault key. See The Vault and your phrase.

Backup status

The Backup row in Account Settings shows the latest state, such as “Backed up 5 minutes ago to Studio Mac” or No backup device. Tap it for the status screen.

If a backup device has been away for 15 minutes, the status says when it was last seen. Turn it on, with the account open in Whispurr, to catch up. Items that only one device has are copied when that device comes online.

The red dot

A red dot on the account's settings gear (on a Mac, on the key beside the account's name) means your backup needs attention. It appears when:

If you don't want a backup device yet, tap Not Now on the status screen to hide the first kind of reminder.

Restore your account

Before you start, make sure a backup device is on, with Whispurr open and Network turned on.

  1. On the new device, tap Restore an account from a backup device during setup. On a device you already use, go to the device home and, under Linked Accounts, tap Restore Account.
  2. Type or paste your 24 words. A counter shows how many you've entered. To use a phrase QR code instead, tap Scan Recovery QR Code or Choose QR from Photos; on a Mac, click Choose Recovery QR Image.
  3. Tap Restore. Whispurr shows Looking for your backup device… and keeps trying until one answers.
  4. When a backup device answers, the new device shows a code and asks you to Approve on your backup device.
    • On a Mac: it asks “Restore this account on” followed by the new device's name. Check that it shows the same code, then click Approve.
    • On a server: run whispurrd restore approve.
  5. On the new device, check the account code and tap Restore and Switch. Your personas and chats are copied from the backup device. Other accounts on this device are kept.
  6. Whispurr lists the account's other devices. Select any you no longer have and tap the button that counts them, such as Remove 2 Devices. Or tap Keep All Devices. See Lost devices.

After a restore, this device holds your recovery phrase and can show it.

Knowing your phrase isn't enough to take your account: someone at a backup device has to approve. If you're asked to approve a restore you didn't start, tap Decline, then make a new recovery phrase.

Lost devices

If a device is lost or stolen, remove it from your account so it stops syncing. You can do this from Approved Devices at any time, or at the end of a restore.

A lost device could still ask for a restore with your current phrase, so removing it replaces the phrase:

Whispurr then shows the new 24 words under Record your new recovery phrase. Write them down and tap I’ve Recorded It. The old phrase stops working everywhere, and your other devices say Recovery phrase replaced.

If this device can't make a new phrase, Whispurr asks you to Make a new recovery phrase on another device. Use one that has opened your Vault.

Removing a device doesn't erase what's already on it. It stops getting anything new, and restoring from a backup never brings it back.

The Vault and your phrase

Your Vault is sealed under its own key. That key is kept on your devices with a screen, behind Face ID, Touch ID or your passcode. It's never given to a server or to any service. Your recovery phrase can also carry a copy of it.

Settings

The backup status screen opens from Account Settings › Backup. The Mac's own backup switches are listed under Account Settings.

SettingWhat it doesDefault
StatusThe account's backup state: last backed up, copying, waiting, or the device last seen.—
Backup DevicesEach backup device and its state. Tap one for its progress, history, problems and storage. With only one, Whispurr suggests a second in another place.None
Not NowShown when there's no backup device. Hides the red-dot reminder.—
Add Backup DeviceMakes a linked Mac or server a backup device. Approve a Mac or a server on the account first. Up to four.—
Remove as Backup DeviceOn a backup device's detail page. It stays linked, but no longer keeps a full copy or answers restores.—
Use as Backup DeviceOn a Mac or server in Approved Devices. The same switch, from the device's own page.Off