> ## Documentation Index
> Fetch the complete documentation index at: https://animus.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Import & Export

> Bring your bookmarks and saved content from X, Instagram, browsers, and other services into Animus

Animus lets you import bookmarks and saved content from a wide range of sources — social platforms, browsers, and bookmark services. Once imported, everything is fully indexed and searchable.

## Import from X (Twitter)

Use the **Animus Exporter** extension to pull your X bookmarks into Animus.

<Steps>
  <Step title="Download the extension">
    Grab the [Animus Exporter](https://github.com/mustay/animus-exporter) from GitHub. Download the ZIP and unzip it.
  </Step>

  <Step title="Load it into Chrome">
    1. Go to `chrome://extensions`
    2. Turn on **Developer mode** (top right)
    3. Click **Load unpacked**
    4. Select the `dist` folder from the unzipped download

    You'll see the Animus Exporter icon in your toolbar.
  </Step>

  <Step title="Confirm you're logged into X">
    The extension uses your existing browser session — no passwords needed. Just make sure you can see your bookmarks at [x.com/i/bookmarks](https://x.com/i/bookmarks).
  </Step>

  <Step title="Export your bookmarks">
    1. Click the **Animus Exporter** icon in your toolbar
    2. Select **Twitter/X**
    3. Hit **Export**

    The extension pulls your bookmarks in batches of 100. When it's done, save the JSON file.
  </Step>

  <Step title="Import into Animus">
    Go to the [Animus import page](https://app.animus.so/import) and upload the JSON file. Animus will extract, index, and make everything searchable.
  </Step>
</Steps>

<Tip>Your credentials stay safe. Auth tokens only exist in memory during the export — nothing is stored. The extension is [open source](https://github.com/mustay/animus-exporter) with zero external dependencies.</Tip>

## Import from Instagram

The same **Animus Exporter** extension supports Instagram saved posts.

<Steps>
  <Step title="Install the extension">
    If you haven't already, follow the extension install steps above ([download from GitHub](https://github.com/mustay/animus-exporter) and load into Chrome).
  </Step>

  <Step title="Confirm you're logged into Instagram">
    Make sure you're signed in to [instagram.com](https://instagram.com) in the same browser.
  </Step>

  <Step title="Export your saved posts">
    1. Click the **Animus Exporter** icon
    2. Select **Instagram**
    3. Hit **Export**
    4. Save the JSON file when the export completes
  </Step>

  <Step title="Import into Animus">
    Go to the [Animus import page](https://app.animus.so/import) and upload the JSON file.
  </Step>
</Steps>

## Import from browsers and other services

Animus supports direct file uploads from browsers and popular bookmark services. Export from the source, then upload the file to Animus.

| Source                | File type | How to export                                                                           |
| --------------------- | --------- | --------------------------------------------------------------------------------------- |
| Chrome / Edge / Brave | HTML      | Bookmark Manager → **⋮** → **Export bookmarks**                                         |
| Firefox               | HTML      | Bookmarks → **Manage Bookmarks** → **Import and Backup** → **Export Bookmarks to HTML** |
| Safari                | HTML      | **File** → **Export Bookmarks**                                                         |
| Pocket                | CSV       | [getpocket.com/export](https://getpocket.com/export)                                    |
| Pinboard              | JSON      | **Settings** → **Export**                                                               |
| Instapaper            | CSV       | **Settings** → **Export** → **Download .CSV file**                                      |
| Raindrop.io           | CSV       | **Settings** → **Backups** → **Export** → **Download**                                  |
| Omnivore              | JSON      | **Profile** → **Export**                                                                |
| Wallabag              | JSON      | **All articles** → **Export** → **JSON**                                                |
| Readwise Reader       | JSON      | **Export** from Readwise dashboard                                                      |
| Generic CSV           | CSV       | Any CSV file with a `url` column                                                        |

<Note>Format is auto-detected. Just upload the file and Animus figures out the rest.</Note>

## How the import works

Once you have your export file, the import flow takes a few clicks:

<Steps>
  <Step title="Upload your file">
    Go to the [import page](https://app.animus.so/import) and drag and drop your file — or click to browse. Supports `.html`, `.json`, and `.csv` files up to 10 MB.
  </Step>

  <Step title="Select what to import">
    Review the parsed bookmarks in a folder tree view. Select or deselect individual items. You can import up to 1,000 bookmarks at a time.
  </Step>

  <Step title="Configure options">
    Choose where to send your imports:

    * **Destination** — your inbox or a specific collection
    * **Folders** — convert folder structure to tags, create collections from folders, or ignore folders
    * **Tags** — add custom tags to all imported items
  </Step>

  <Step title="Import">
    Hit import. Processing happens in the background — you'll see a live progress bar with counts for imported, duplicates, and failed items. You can cancel anytime.
  </Step>

  <Step title="Done">
    You'll get a summary when it's complete. Animus also sends you an email notification so you don't have to wait around.
  </Step>
</Steps>

## Good to know

* **Duplicates are skipped** — if a URL already exists in your library, it won't be imported again.
* **Import history** — view all your past imports and their status on the [import page](https://app.animus.so/import).
* **Folder structure preserved** — folders from your export can become tags or collections in Animus, keeping your organization intact.

## FAQ

**What file formats are supported?**
HTML, JSON, and CSV. Animus auto-detects the source format — just upload the file.

**Is there a limit on how many bookmarks I can import?**
You can import up to 1,000 bookmarks per batch. For larger libraries, run multiple imports.

**What happens to duplicates?**
Animus checks URLs against your existing library and skips any that are already saved.

**Is the Animus Exporter extension safe?**
Yes. It's open source with zero external dependencies. Auth tokens only exist in memory during the export and are never stored.

**Can I cancel an import?**
Yes. You can cancel any in-progress import from the import page.

**Which platforms does the Animus Exporter support?**
Currently Twitter/X and Instagram. More platforms are on the way.