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.xml | In Readwyn |
|---|---|
Title | The title. If there's no Title, the series and number (“The Lantern Keeper #1”), then the series alone, then the file name. |
Writer, then Penciller | The authors, each name once, in that order. If neither is set, CoverArtist. |
Series, Number | The series and the number in it. A Number that isn't numeric becomes 1. |
Volume | Kept with the book's metadata. The book screen doesn't show it. |
Summary | The description. |
Publisher | The publisher. |
Year, Month, Day | The published date, as exact as the fields allow: a year, a year and a month, or a full date. |
LanguageISO | The language. |
Genre | The genres. |
Tags | The subjects of the file, not the tags of your library. |
GTIN | The ISBN if it's a valid ISBN, else a GTIN identifier. |
Manga | YesAndRightToLeft 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 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.