Readwyn 0.1.0

How to change the title of a sideloaded book on a Kindle

The title that a Kindle lists for a sideloaded MOBI book is written inside the book file, so renaming the file in Finder doesn't change it. The title has to change in the file, and the file has to be copied again. In Readwyn, correct the title in “Edit details”, then choose “Send to device again” with the Kindle plugged in. The copy that lands on the Kindle carries the new title. This works for a Kindle that the Mac mounts as a disk, which is the only way Readwyn reads one. Amazon's help page on USB transfers says a Kindle Scribe and the Kindles released in 2024 need a separate application on a Mac, and that models released earlier than 2024 (the Scribe aside) don't. Readwyn works with the earlier ones.

Change it and send the book again

  1. Open the book in Readwyn and click “Edit details”, or press ⌘E.
  2. Type the new title. The field shows “Was” with the old title struck through, and the button counts the change: “Save 1 change”. If the Kindle is connected and the book is on it, the footer adds “Your Kindle keeps the old details until you send the book again.”
  3. Save. Then click “…” (“More actions”) on the book screen and choose “Send to device again”.
  4. When Readwyn says “Copied to the device. Eject the device so it adds the book.”, click “Eject device” on the Sync screen and unplug the Kindle (more on ejecting).

Readwyn replaces the file in place. It can't make the Kindle read the file again. If the Kindle still lists the old title after you unplug it, take the book off the Kindle and send it fresh, by the steps under “The file name keeps the old title”, which also say what that costs.

The book screen of Middlemarch, with a Kobo Clara 2E connected and the line On Kobo Clara 2E under the cover: the title and author, and the buttons Continue reading, Status: Reading, and Edit details
“Edit details” is on the book screen, and “Send to device again” is in the “…” menu beside it

The other fields of the sheet are covered in how to edit ebook metadata on a Mac. The author works the same way as the title: the copy on the Kindle gets the authors that the library has when you send.

Why renaming the file isn't enough

A MOBI file has a name on the disk and a title inside, and the two are independent. The MobileRead wiki's notes on Mobi2Mobi, a tool that edits this metadata from the command line, make the distinction: you can rename a .mobi file in Windows Explorer or in Finder, but “you can only change the books Metadata with Mobi2Mobi”. The same page uses the inner title for a trick. It puts a short genre code at the front of each title, so that the Kindle's sort by title groups the books by genre.

Readwyn's copy holds the title in three places. Two of them, the full name and the record that the wiki's page on the MOBI format lists as 503, “updatedtitle”, take the whole title exactly as you typed it, in any script. The third is the name of the Palm database, which the format limits to 31 bytes. Readwyn fills it with the ASCII letters and digits of the title and puts _ for everything else. A title with no such letter or digit, a Tamil one for example, gets the name book there.

None of this touches the EPUB in your library. Readwyn keeps a book's details in its own library and never writes them into your book files, so “Send to device” takes the title from the library at the moment you send. The text of the copy comes from the documents of the EPUB, character for character, and the title you typed isn't added to it. A title page inside the book still shows the title as the EPUB prints it.

The file name keeps the old title

The first time you sent the book, Readwyn wrote it to documents/<title> - <first author>.mobi and recorded that path. A later send goes to the recorded path, so the new copy replaces the old one and the Kindle doesn't end up with the book twice. The file is still named after the old title, though, which shows when you browse the Kindle in Finder.

If you want the file renamed too, take the book off the Kindle and send it fresh:

  1. With the Kindle connected, open the book's Details tab. In the row “On the device”, click “Remove from device”. Readwyn deletes the file and forgets its path.
  2. Choose “Send to device”. The book goes to documents/<new title> - <first author>.mobi. A character that the Kindle's disk refuses in a file name, a colon for example, becomes _.

This route costs something. “Remove from device” also deletes the files that the Kindle kept beside the book: its .mbp file on an older Kindle, or its .sdr folder on a newer one. They hold the Kindle's place in the book and the highlights and notes you made there. So run “Device → Readwyn” on the Sync screen first, which brings progress, highlights and notes into the library. They stay in the library, but they don't all go back. Readwyn sends no highlights or notes to any Kindle. Progress returns only to a Kindle on firmware 1 to 4, and only after that Kindle has opened the new copy once (what a Kindle sync carries).

A book that you copied by hand

Readwyn doesn't patch a book file on the Kindle. “Send to device” always writes a whole copy, made from the EPUB in the library. A book that you dragged to the Kindle yourself therefore has to be in the library first: add the file, set its title, and send it. A MOBI or an AZW3 gets an EPUB 3 at import. A file with DRM doesn't convert, and without that EPUB the send stops with “Not copied: the book has no EPUB file”.

If you highlighted in the book on the Kindle, run “Device → Readwyn” on the Sync screen after you add the file and before you change the title. Readwyn finds a book that it didn't send by the title inside the file, so the sync reaches the book only while the two titles still agree. The same sync records where the file is, and the send that follows replaces it in place.

Afterwards, look in the Kindle's documents folder in Finder. If it holds two files for the book, the old one and a new one named after the title you set, the Kindle has the book twice, once under each title. Delete the one that you copied by hand. The Kindle kept its place in the book and the highlights you made there beside that file, in its .mbp file or its .sdr folder, so the new copy starts without them.