Readwyn 0.1.0

Fetch covers and descriptions for your ebooks

A fetch asks Open Library and Google Books for a book's cover, description, page count and genres, and puts what it finds into the edit details sheet. Nothing is stored until you click “Save”, so you see every value, and where it came from, before it touches your library.

Starting a fetch

On the book screen, open the “…” menu and choose “Fetch metadata”. The Details tab has the same button: “Fetch metadata”, or “Fetch again” once the book has been fetched. If the edit details sheet is already open, its own “Fetch metadata” does the same job.

A fetch always works on one book. The sheet for many books has no fetch button.

The book screen of Middlemarch: the cover, the title, the reading progress, and the description on the Overview tab
The description shows on the Overview tab

What it fills

A fetch brings in the description and the cover, any identifiers the book is missing, and a page count if the book has none or only the estimate from its word count. It only adds genres that the book lacks, and the sheet says which, for example “Added Victorian and Romance”. It never adds tags: fetched genres go in the genre field, and your tags remain your own.

Checking the result

Each fetched field shows its source on the right, for example “Open Library”, and a fetched cover is marked “New cover · Open Library”. The sheet sums the fetch up as “Fetched from Open Library. 4 fields changed.”, and the save button reads “Save 4 changes”.

If you don't want one of the values, click “Undo” on its field, as with any other edit in the sheet. “Cancel” or Escape closes the sheet without saving anything, after an alert if fields changed.

Once you save, the labels go, and the Details tab's “Details from” row keeps the source and the date of the fetch.

Changing only the cover

Open the edit details sheet (⌘E) and click “Change cover”. Under “Fetch a cover” are “From Open Library” and “From Google Books”, and each asks that source only. As with a full fetch, the new cover waits in the sheet until you save. The other items of that menu, from “Choose an image…” to “Remove cover”, are in the post on editing a book's details.