Comics Structure

Make sure you understand the folder requirements of Kavita

Kavita parses Comics just like it does Manga but uses additional keyword identifiers. If you are having trouble, you might want to look at the different cases we have in our code and what is supported. The following will give you a glimpse.

The same naming conventions work with Comics.

┖── Series Name
    ┠── Series Name v01.cbz
    ┠── Series Name v02.cbz
    ┖── Series Name v03 c01.cbz

The following will be parsed as "Chapters", which may naturally group into a Volume entity if a volume is on the file itself.

Filename Parsed Series Name Volume Chapter
Invincible 070.5 - Invincible Returns 1 (2010) (digital) (Minutemen-InnerDemons).cbr 70.5
Batman & Wildcat (1 of 3) 1
Amazing Man Comics chapter 25 25
Superman v1 024 (09-10 1943) 1 24
Y - The Last Man 1
Batgirl Vol.2000 #57 (December, 2004) 57
Babe 01 1
Babe T1 01 1 1

If you have multiple comics from different years, you can name them as "Fables {2004}" and "Fables {1989}". Then in Kavita's UI, you can rename the "Name" field to be "Fables (2004)" and "Fables (1989)" so they are separate series. This workaround is the only way for different releases of the same series to be supported in Kavita. Note that anything withing () will be stripped during parsing as there is usually junk in there. Use {} or embedded metadata.

Comics also have a list of special filename keywords that will mark them as specials. Some of these are:

  • Specials
  • Annual
  • Extra Chapter
  • Book
  • Compendium
  • OneShot
  • Extra
  • FCBD
  • TPB
  • Side Stories
  • Art Collection
  • Absolute
  • Preview
  • Omnibus
  • Bonus
  • Hors Série
  • HS
  • THS

Note: The "Format metadata field" for the ComicInfo metadata can also be used to mark the comic as a special.