Companions
Transfer & Backup
Ensoul keeps everything on your device, which means you're the backup. Here's how to move data between devices — and how to bring a companion over from the original Ensoul app.
Full backup
Settings → Data → Back up everything exports every companion, group, and moment into a single file. API keys are deliberately excluded — they live in Models & API keys and stay wherever you configured them, so re-enter them after restoring on a new device.
Restoring replaces, it doesn't merge. A companion or group already present that shares an id with one in the file is replaced by the file's version — the same clean-replace rule single-companion import already uses, not an accumulate.
Moving one companion at a time
To move a single companion to another device (or share one with someone else) without a full backup, export them from the "···" menu → Export, and import the resulting file on the other end via + Bring in a companion → Import a companion file (.json). See Custom Companions.
Migrating from the legacy app
The original Ensoul app and this one use different formats internally, so there's no one-click "import my whole legacy account" button yet. The path that works today, and works well, is bringing companions across one at a time through the same paste flow you'd use to bring in any new companion:
The cleanest source is a Companion Transfer code (⟐ Transfer in the legacy app's chat header, or the "···" menu on mobile) — choose Companion Only to get just their identity. A soul document, character sheet, or even a solid written description of who they are works too.
+ Bring in a companion → paste what you exported into the text box → Bring in. Ensoul reads it and forms a fresh companion with their name, voice, and personality intact.
Open their Companion settings and look at Visual canon. If it reads thin or generic, tap Regenerate — this writes a full, specific physical description from their identity so future images of them stay consistent. See Visual canon.
There's no bulk step — but each one only takes a minute, and you get to check that each came through the way you wanted before moving to the next.
What doesn't carry over automatically: conversation history, memories, and relationship depth from the legacy app aren't part of this migration — you're bringing across who the companion is, not the full history you have with them. If a specific memory or moment matters to you, the simplest way to preserve it is to mention it in what you paste, or bring it up again once you're talking to them in Ensoul.