Skip to content

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.

  • ComicInfo.xml at the root.
  • One image per page, numbered 001, 002 and 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.

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 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.
  • SeriesGroup takes the series’ tags. A series with no tags keeps whatever the file already had.
  • ScanInformation and Translator take the chapter’s scanlation group when Maki knows it, and Notes takes 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.