Give Readwyn access to your Kobo in the Mac App Store version
The first time you connect a Kobo, the Sync screen asks for access, using the name the Kobo shows in Finder, usually “Give Readwyn access to KOBOeReader”. Click “Select KOBOeReader…”, then “Allow” in the Finder window that opens at the Kobo. Readwyn remembers that Kobo, so you won’t be asked again.
The step exists because the Mac App Store version runs in the App Sandbox, where macOS lets an app read a folder outside its own container only after you’ve selected it in a Finder dialog.
Before you give access
Readwyn can tell that a device is plugged in, but it can’t look inside. The sidebar card says “Connected · needs access”, and the Sync screen shows the device with “Readwyn can see the model and your books after you give access.” That’s also why the notice uses the volume name rather than the model: the model is written in a file on the Kobo that Readwyn can’t open yet. In a test of the sandboxed build on a copy of a Kobo’s storage, until the Kobo was selected, macOS wouldn’t even let Readwyn read the Kobo’s version file.
Next to the button is the hint “A Finder window opens at the device. Click Allow.”
Once you click “Allow”, Readwyn reads the Kobo: its model, its books, and the changes in each direction. The two direction cards appear, and from then on syncing and sending books work as they do outside the sandbox, with the same backup before every write.
What Readwyn keeps
Selecting the Kobo gives Readwyn a security-scoped bookmark, which is how macOS lets a sandboxed app reopen a folder later. The bookmark lives in the app folder and is opened each time the Kobo is read. The background server runs as the same app, in the same container, with the same bookmarks, so you give access once, not once for the app and again for the server.
A calibre library needs the same one-off step. In the sandbox, “Import from calibre…” opens a Finder dialog at the usual place of a calibre library in your home folder, and you select the folder that holds metadata.db.