Readwyn 0.1.0

How to edit ebook metadata on a Mac

You edit a book's title, authors, series, cover and the rest of its details in one sheet. Open the book and click “Edit details”, or press ⌘E. The sheet marks each field you change and stores nothing until you click “Save”. Even then your EPUB, MOBI or PDF stays byte for byte as it was: Readwyn keeps the details in its library, not in the file.

The book screen of Middlemarch: the cover, the title and author, and the buttons Continue reading, Status: Reading, and Edit details
“Edit details” is next to the status

The sheet

“Edit details…” in the book's “…” menu opens it too. The cover, “Change cover” and the identifiers sit on the left. On the right is a single column: title, authors, series and number, publisher, published date, language, voice, pages, genres, tags, the section in the 3D library, and the description.

A changed field fills with colour, gets a dot before its label, and shows “Was” with the stored value struck through, next to “Undo”. If the field was empty before, it says “Was Not set”. The footer counts your changes, and so does the button: “Save 2 changes”.

Return in a single-line field saves. In the description, Return starts a new line and ⌘Return saves. Escape or “Cancel” closes the sheet, but if anything changed you're asked first: “Discard 2 changes?”, with the fields that would go back, “Keep editing” and “Discard changes”.

Fields with their own rules

Typing in Authors opens a menu of matching authors from your library, each with its number of books, and “Add “Kal” as a new author” at the end. Up, Down and Return pick an item.

A title is kept exactly as you type it, in any script (a Tamil title such as “பொன்னியின் செல்வன்” comes back unchanged), but it can't be blank. The published date can be a year (“1871”), a month and year (“Apr 2003”) or a full date (“29 Apr 2003”), and Readwyn stores only what you typed, so a year stays a year.

If the book has no page count, Pages shows an estimate from the word count (how it's worked out), and typing a number replaces it. The language you pick from the menu becomes the book's first language, while any others stay. Changing it also sets the Voice back to Automatic.

“Change cover” offers “Choose an image…” (⌘O), “Paste image” (⌘V), “Use the cover in the book file”, a fetch “From Open Library” or “From Google Books”, and “Remove cover”. A JPEG, PNG or GIF cover is stored with its bytes unchanged; a TIFF, WebP or BMP image is turned into a PNG.

Fetching instead of typing

“Fetch metadata” in the sheet asks Open Library and Google Books for the cover, description, page count and genres. The post on fetching covers and descriptions says what it fills and what it leaves alone.

After you save

Only the fields you changed are saved; the rest stay exactly as they were. If the book is on your connected Kobo, the footer warns that “your Kobo keeps the old details until you send the book again”.

The series, authors or tags of a whole set of books change in one sheet for many books: select them in the library and press ⌘E there.