Skip to main content

Sync across devices

Paid plans can keep notes, dictionary, modes, settings, and encrypted provider keys aligned across devices. Sync is license-gated (Pro, Trial, Max — not Free). Manage it under Account → Sync: turn on, pause automatic sync, sync now, or reset the cloud copy.

What syncs

BucketContents
entriesNotes and related workspace entries
dictionaryCustom dictionary words
modesDictation modes and their settings
settingsApp preferences that travel with the workspace
provider_keysAPI keys — encrypted on the device before upload

Last write wins on each item's timestamp. Audio, raw history blobs beyond synced entries, and local-only secrets that are not in these buckets stay on the device.

Provider keys stay encrypted

Kalam encrypts provider_keys with an account-scoped secret on your device. Servers store ciphertext; BYOK keys are not sent in the clear. See BYOK providers.

Enable, pause, and sync now

  1. Sign in and ensure you have an active paid plan (Account → Plan).
  2. Open Account → Sync.
  3. Click Turn on to enable sync for this device.
  4. Use Sync now anytime to push/pull immediately.
  5. Click Pause to stop automatic sync while keeping Sync now available; Resume restores automatic sync.
  6. Click Turn off when you want this device to stop syncing entirely.

Unpaid accounts see a note that sync requires Pro or Max. Profile and plan details: Account.

Restore on a fresh install

On a new install that already has cloud sync data, the first time you enable sync Kalam asks whether to restore your cloud configuration or start fresh — instead of silently overwriting the cloud copy with factory defaults.

  • Choose what to restore. A dialog lists each bucket with a count and a preview (for example, dictation-profile names). Tick the buckets you want — dictation profiles, settings, dictionary, notes & tasks, and API keys — or restore all.
  • Start fresh keeps your cloud data intact and uploads this device's local defaults. Nothing on the server is deleted.
  • If there's no cloud data yet, sync simply turns on with no prompt.

This choice is per install. Restoring merges the selected buckets into the local device; anything you skip keeps its local state.

Reset cloud sync data

  1. On Account → Sync, open Advanced.
  2. Choose Reset cloud data.
  3. Confirm. The server copy is cleared; local data on this device is unchanged.

After a reset, the next sync uploads from devices that still have local data — coordinate if multiple machines are linked.

Data retention

Kalam doesn't keep sync data forever:

  • Deleted items (tombstones) are permanently removed after 90 days.
  • If an account has had no active paid plan for 180 days, its synced data is purged.

Deleting your account removes sync data immediately.

Plan gate

Sync needs a valid paid license on the device. Free signed-in accounts can use other account features but not this sync pipeline.