Readwyn 0.1.0

Import a calibre library in the Mac App Store version of Readwyn

The Mac App Store version runs in the macOS App Sandbox, which means Readwyn can only read a folder outside its own container after you’ve picked that folder in a Finder dialog. So the import starts with one extra step: you point it at your calibre library yourself.

Picking the calibre library

Open the “Import from calibre” sheet, from the welcome page of an empty library or from the library switcher at the top of the sidebar. Instead of a folder, it shows “Choose the folder of your calibre library.” with the note “Readwyn can open only a folder that you pick.” and a “Choose calibre library…” button.

  1. Click “Choose calibre library…”. Finder opens at the usual calibre library location in your home folder.
  2. Select the folder that has metadata.db in it, and click “Choose”.
  3. Readwyn scans it; while it does, the sheet says “Reading the library…”.

Until a scan finds books, the main button just says “Import” and does nothing. Once it has, the sheet shows the folder with a “Choose…” button, what the scan found and how long the import should take, for example “Found 1,206 books, 3.4 GB” and “About 15 minutes for this library.” The button then counts the books: “Import 1,206 books”. Under “Import into” you choose where they go: a new library or one that has never held a book (which to pick).

The sheet Import from calibre after the scan: 1,206 books and 3.4 GB found in Calibre Library, about 15 minutes to import, then the choices under Import into
After the scan: what it found and how long the import should take

Pick a folder without metadata.db and nothing is created: the sheet goes back to its “Choose calibre library…” button, so you can try another folder.

Once you start it, the import is the same as in any other version of Readwyn. It runs in the background, so you can keep reading or syncing, or close the window; the calibre import walkthrough shows the progress and what “Stop import” does.

A Kobo needs the same permission

The sandbox applies to a Kobo as well. The first time one connects, the Sync screen says “Give Readwyn access to Kobo Clara 2E” with a “Select Kobo Clara 2E…” button. Finder opens at the device, and “Allow” grants access; Give Readwyn access to your Kobo in the Mac App Store version has the details. If calibre used to fill that Kobo, finish the import before its first sync, so the books calibre sent there can match your library books by their calibre uuid (more on moving a Kobo over from calibre).

If Readwyn server is on

If you’ve turned on Readwyn server, the menu bar agent holds your libraries and runs the import, and that process needs to read your calibre folder too. When you pick the folder, Readwyn saves a security-scoped bookmark of it in access.json in its app folder. The agent is the same app in the same container, so it opens that bookmark, and you don’t have to pick the folder twice.