# Import from Audiobookshelf

> Bring your Audiobookshelf server's audiobooks and ebooks into Boeks, with where you were, what you finished, your bookmarks, your listening sessions, and your collections.

Canonical: https://boeks.app/docs/guides/import-from-audiobookshelf

Boeks imports the books on your Audiobookshelf server in one step: its audiobooks and ebooks, downloaded into your library as files, with their details, where you were, what you finished and when, your bookmarks, and your listening sessions. The server is only read, never changed, so you can keep using it.

## Import from your server

Open your Boeks library, and in the empty library choose **Import From… › Audiobookshelf…**. If it already has books, choose **File › Import From › Audiobookshelf…** on a Mac, or **+ › Import From › Audiobookshelf…** on iPhone and iPad.

Type your server's URL, and sign in:

- **With your username and password,** as in Audiobookshelf's own app.
- **With an API key,** if your server signs in another way, such as with your Google account. An admin makes one in the server's settings, under API Keys, for your account. Switch it on when you make it.

Boeks doesn't keep your password or key. It shows what it'll bring over, and **Import** starts it. You can hide its progress and keep reading, or stop it: the books already imported stay.

Your account needs to be allowed to download. If it isn't, Boeks says so, and an admin can allow it in the server's user settings.

## What comes over

- **Audiobooks and EPUBs.** A book with both becomes one book with two editions, so you can read along and pick up in either where you left the other. An audiobook in several MP3s stays one audiobook.
- **Details.** Titles, authors, narrators, series, genres, publishers, dates, and descriptions are written into the files where the server's differ from them. Covers too, when the server's is another picture, and chapters you fixed on the server.
- **Read status,** with when you started and finished.
- **Where you were,** in the audiobook and in the ebook.
- **Bookmarks** in the audiobooks, with their titles as notes.
- **Listening sessions,** each with when and how long you listened, so your reading time and history start where they were.
- **Collections, playlists, and tags,** each as a collection of the same name.

Books you imported before are skipped, so importing again adds only what's new. If your server has several libraries of books, you choose which to import.

A book you already have in Boeks isn't added again: where you were, what you finished, and your collections come into the book you have, and its own details and files stay. Your bookmarks and listening sessions come only if it has the very same audio, as a time in one recording isn't a place in another. Boeks lists these books before importing, so you can turn off any that aren't the same book.

## What doesn't come over

- **Podcasts,** and books with only a PDF or other ebook format Boeks doesn't read.
- **An audiobook in several files that aren't MP3s,** which Boeks can't play as one yet. Its ebook still comes over.

When the import is done, Boeks lists what came over and anything it couldn't bring over.

## From the terminal

The `boeks` command imports from a server too:

```sh
boeks import --audiobookshelf https://example.com/audiobookshelf --api-key YOUR-KEY
```

Or sign in with `--username`, with the password in `AUDIOBOOKSHELF_PASSWORD` or typed on standard input. Add `--dry-run` to see what it would bring over first, and `--from-library` to pick a library by name. `--leave-out` and an item's ID, as the dry run lists them, leaves out a book that isn't the one in your library.
