CBZ and ComicInfo.xml
Each chapter Maki downloads becomes one CBZ, a zip archive with a ComicInfo.xml at its root. This
page helps if you read the files in another app, or want to know why a field looks wrong in Kavita
or another reader.
What is inside
Section titled “What is inside”ComicInfo.xmlat the root.- One image per page, numbered
001,002and so on, with the source page’s extension. Numbers have at least three digits, so readers that sort names as text still get the pages in order. Page conversion can rewrite the pages as WebP, AVIF or JPEG XL and keep the numbers. See Page conversion.
Page images are stored without compression, since JPEG and PNG are already compressed. Maki writes
the archive to a .partial file and moves it into place when complete, so a reader never opens a
half-written file.
Off by default. With Save a cover.jpg into each series’ library folder on, under Settings,
Library, ComicInfo & covers, the series folder also gets a cover.jpg beside the CBZ files, not
inside them.
ComicInfo.xml fields
Section titled “ComicInfo.xml fields”| Field | Source |
|---|---|
Series |
The series’ English title |
LocalizedSeries |
Original title for English chapters. Other languages take an alt title in their language, else the original title |
Title |
The chapter title. If there is none, Chapter N, or the series title for a chapter without a number |
Number |
The chapter number |
Volume |
The chapter’s volume, when the source gives one |
Count |
The series’ total chapters, only once the series is completed |
Summary |
The series overview |
Year, Month, Day |
The chapter’s release date, when known |
Writer |
Story authors |
Penciller |
Art authors |
Publisher |
Publisher |
Genre |
Series genres |
Tags |
Series tags from metadata |
SeriesGroup |
Your own tags on the series, which Kavita and Komga turn into collections |
Web |
Links to the series on MangaBaka, AniList, MyAnimeList, and the other sites Maki knows |
LanguageISO |
The chapter’s language |
Manga |
Reading direction, from the series type (see below) |
AgeRating |
From the series content rating (see below) |
ScanInformation |
The scanlation group. A scanlator site with no group on the chapter uses the site name |
Translator |
The same scanlation group |
Notes |
The source, the chapter’s URL there and the file’s quality tier |
PageCount |
Number of pages in the chapter |
Pages |
Marks the cover and every two-page spread |
Manga follows the series type:
| Series type | Value |
|---|---|
| Manga | YesAndRightToLeft |
| Manhwa, manhua | Yes (left-to-right with manga-style reading) |
| OEL and other types | No |
A type Maki does not recognize gets the manga default.
AgeRating maps the content rating: safe becomes Teen, suggestive becomes Mature 17+, erotica
becomes Adults Only 18+, and pornographic becomes X18+. Safe maps to Teen because Maki’s ratings
say nothing about violence.
Files Maki adopts
Section titled “Files Maki adopts”Files Maki did not download, such as library imports or finished torrents, can get their ComicInfo.xml rewritten. The Write ComicInfo.xml into imported files switch, on by default under Settings, Library, ComicInfo & covers, controls this:
- Series-level fields (title, summary, authors, genres) are standardized to Maki’s metadata.
- Number and volume always come from the linked chapter or the file name. The date comes from the chapter when it has one. Title is kept unless it is empty.
SeriesGrouptakes the series’ tags. A series with no tags keeps whatever the file already had.ScanInformationandTranslatortake the chapter’s scanlation group when Maki knows it, andNotestakes the source and quality tier when the file came from a source.- Fields Maki has no opinion on, such as characters, and unknown elements stay as they were.
Adding or removing a tag does not rewrite any files, since that would mean rewriting every chapter of the series at once. New downloads and newly adopted files pick up the current tags. To bring existing files up to date, select the series in the library and pick ComicInfo from the bulk actions.
Torrent imports rewrite ComicInfo.xml only when every file was copied. A hardlinked file is left alone, because a rewrite would replace the shared file with a full copy and undo the hardlink.