Readwyn 0.1.0

What ComicInfo.xml does for your comic library

ComicInfo.xml is a small metadata file that sits inside a comic archive. When you add a CBZ, CB7, or CBT, Readwyn reads it to fill in the title, authors, series and number, publisher, date, language, summary, genres, cover, and reading direction. A comic without one still comes in, with its file name as the title.

Which file Readwyn reads

Readwyn looks for an entry called ComicInfo.xml, ignoring upper and lower case. If there's more than one, the one at the root of the archive wins, otherwise the one in the shallowest folder. Copies inside __MACOSX or a hidden folder don't count. If the file is malformed, Readwyn ignores it and imports the comic anyway.

The fields

In ComicInfo.xmlIn Readwyn
TitleThe title. If there's no Title, the series and number (“The Lantern Keeper #1”), then the series alone, then the file name.
Writer, then PencillerThe authors, each name once, in that order. If neither is set, CoverArtist.
Series, NumberThe series and the number in it. A Number that isn't numeric becomes 1.
VolumeKept with the book's metadata. The book screen doesn't show it.
SummaryThe description.
PublisherThe publisher.
Year, Month, DayThe published date, as exact as the fields allow: a year, a year and a month, or a full date.
LanguageISOThe language.
GenreThe genres.
TagsThe subjects of the file, not the tags of your library.
GTINThe ISBN if it's a valid ISBN, else a GTIN identifier.
MangaYesAndRightToLeft makes the comic read from right to left.

Writer, Penciller, and Genre take lists separated by commas, so a Writer of “Mira Okafor, Tomas Lindqvist” gives two authors.

The book screen of the comic The Lantern Keeper: the title, the authors Mira Okafor and Tomas Lindqvist, 2024, 10 pages, English, and CBZ
A comic’s book screen, with its title, authors, year, and language

The pages

The Pages block describes individual pages. Each Page points at an image by its position in the reading order, starting at 0.

  • Type="FrontCover" marks the cover. The first page marked this way becomes the book's cover; with no mark, the first page does.
  • Type="Deleted" takes a page out of the reading order. If every page is marked deleted, Readwyn assumes the marks are a mistake and keeps them all.
  • DoublePage="true" marks a double-page spread. The page reader shows it alone across the window, as it does any page that's wider than it is high.

The page count and the order

The page count comes from the archive: it's the number of page images, less any that ComicInfo.xml marks as deleted, and the Details tab of the book screen shows it as “24 · from the archive”. The order of the pages comes from their file names, never from the metadata.

Comics from calibre

A calibre import keeps the metadata you set in calibre. From the archive it adds only the page count, if calibre has none, and the reading direction from ComicInfo.xml. Importing your calibre library covers the rest of the import.

Change the details later

Readwyn takes the details from the file once, when you add the comic. After that they're Readwyn's own, and you change them with “Edit details” on the book screen, as for an ebook.