Before you import.
What to know before you point Saga at a backup: the Mac it needs, the key it asks for, what can leave the machine.
- A Mac macOS 14 or later
- The backup From an Android phone
- The 64-digit key Kept in the Keychain
- Your archive Read on this Mac
What do I need?
A Mac on macOS 14 or later, an Android backup and its 64-digit encryption key. USB import needs a cable, USB debugging and permission on the phone. Leave room for the vault, index and temporary files.
Why does macOS say it can't verify Saga?
Saga is not notarised yet, so macOS has no Apple ticket to check. Click Done on the alert, open System Settings → Privacy & Security, scroll to Security, click Open Anyway beside Saga and confirm with your password. The button only exists for about an hour after a blocked launch; if it has gone, launch Saga again and go straight back to Settings. The full steps are on Get started.
Does Saga work with iPhone?
Saga is Android first. iPhone import is experimental: the format is handled, but there is no verified, non-technical flow yet, so don't rely on it as your only backup.
Where do I get the encryption key?
It is the key for your end-to-end encrypted WhatsApp backup, and it can unlock that backup, so keep it private. Saga's file import expects the 64-digit key, not a backup password. If you have lost it, never send your backup or credentials to strangers offering recovery.
Do I need Apple Intelligence?
No. Browsing, search and Wrapped work without it. AI features can use Apple Intelligence on supported Macs with macOS 26 or later, or a local Ollama or LM Studio server — you supply the model.
Is the vault encrypted?
Not by default. Encryption is off until you turn it on: it seals message segments and settings with AES-256-GCM under a passphrase, and gives you a recovery code. The search index and caches stay readable, so protect the whole machine too.
Can it recover deleted messages?
Saga keeps what it has already imported, even if a later backup drops it. It can't recover messages missing from every backup you give it.
Can I import the incremental backup files?
WhatsApp's incremental backup files aren't supported yet. Make a new full backup on the phone and import that.
Does anything leave my Mac?
The vault, search and built-in AI stay local; setup may download Google's Android tools. Previews are off by default, but opening a player or a link contacts its provider. Privacy lists each case.
Can I share a Wrapped page?
Yes. It is a standalone page or PDF that can quote messages; the privacy page says what goes into one.
How do I report a problem?
Open an issue on GitHub with the steps and the error message. Never attach messages, contacts, backups or keys.