# Set up your library

> Choose a folder for your books, sync it between your devices, and add your EPUBs.

Canonical: https://boeks.app/docs/guides/set-up-your-library

Your Boeks library is a folder. Choose one in Boeks, add your EPUBs, and Boeks files them and keeps everything about your reading next to them. There is nothing else to set up: no account, no server.

## Choose a folder

On your Mac, choose **Choose Library Folder…** and pick a folder, new or with books already in it. On iPhone and iPad, pick the same folder in the Files browser Boeks shows.

Put the folder somewhere that syncs between your devices, and they all share one library:

- **iCloud Drive** is built into every Mac, iPad, and iPhone, and is the simplest choice.
- **Dropbox**, **Google Drive**, and other services that sync a folder work too.
- **Syncthing** and **WebDAV** keep your files on machines you control.

With [Boeks Unbound](/pricing), your devices also sync with each other directly over Wi-Fi, so reading done on one shows on another even before your sync service catches up. See [Sync over Wi-Fi](/docs/guides/sync-over-wifi).

## Keep the hidden folders

Boeks keeps what you read, highlight, and note in small `.boeks` folders inside your library: one for the library, and one in each book's folder. Some sync services skip hidden folders unless told otherwise. Make sure yours syncs them, or your devices won't see each other's reading.

## Add your books

Add EPUBs one at a time, or a whole folder at once, subfolders included. Boeks files every book as **Author / Title**, the same way on every device.

If you use Calibre, you can import its library instead, with your ratings, read status, and highlights. See [Import from Calibre](/docs/guides/import-from-calibre).

If you like, Boeks also upgrades older EPUB 2 books to EPUB 3, which can hold more of a book's details, such as several series. Turn on **Upgrade EPUB 2 books on import** in Settings › Library, or upgrade the ones you have all at once there. It changes only a book's details, never its text or your highlights.

Books with DRM are shown with a label, but Boeks doesn't open them: it reads DRM-free EPUBs, like those from Standard Ebooks or Kobo's DRM-free titles.

## What's in the folder

Next to each EPUB are plain files you can read and edit yourself:

- `Book.md` with the book's status, rating, collections, and review.
- A Markdown file per edition with its highlights and notes. See [Your highlights as Markdown](/docs/guides/highlights-as-markdown).

If you stop using Boeks, all of it stays readable, in a folder that's yours.
