Skip to content

Matching

This page covers how Kapowarr matches certain things.

Matching using year

If it is an option to match using the year, both the release year of the volume and the release year of the issue is allowed. The year is also allowed to be off by one from the reference year.

The Special Version affects the matching

Make sure that the Special Version of the volume is correct, as it influences the matching criteria. If a specific string is required, most common variations are also supported. For example, if the string 'one-shot' is required, the variations 'one shot' and 'os' are also allowed. And upper case or lower case does not matter.

Files to Issues

This covers how Kapowarr matches files to issues of a volume. Information is extracted from the filename, folder and parent folder.

Normal Volume

Rules:

  1. Has to mention issue number and should match.
  2. Either year or volume number has to be mentioned and should match.

Examples:

  1. Iron-Man Volume 2 Issue 3.cbr
  2. Batman (1940) Vol. 2 #11-25.zip

'Volume As Issue' Volume

This is a volume where the issue titles are in the format 'Volume N'.

Rules:

  1. Volume number of file refers to issue number of volume or volume number of file refers to volume number of volume and issue number of file refers to issue number of volume.
  2. Either year or volume number has to be mentioned and should match.

Examples:

  1. Invincible Compendium (2011) Volume 2 - 3.cbr
  2. Invincible Compendium (2011) Volume 1 Issue 2 - 3.cbr

TPB Volume

Rules:

  1. Is allowed to have 'TPB'.
  2. Is not allowed to have issue number.
  3. Either year or volume number has to be mentioned and should match.

Examples:

  1. Silver Surfer Rebirth (2022) Volume 1 TPB.cbz
  2. Silver Surfer Rebirth (2022) Volume 1.cbz
  3. Silver Surfer Rebirth Volume 1.cbz
  4. Silver Surfer Rebirth (2022).cbz

The following is not allowed:

  1. Silver Surfer Rebirth Volume 1 Issue 001.cbz

One Shot Volume

Rules:

  1. Has to mention 'one-shot', issue number 1 or no issue number.
  2. Either year or volume number has to be mentioned and should match.

Examples:

  1. Elvira Mistress of the Dark Spring Special One Shot (2019) Volume 1.cbz
  2. Elvira Mistress of the Dark Spring Special (2019).cbz
  3. Elvira Mistress of the Dark Spring Special Volume 1.cbz
  4. Elvira Mistress of the Dark Spring Special Volume 1 Issue 001.cbz

Hard Cover Volume

Rules:

  1. Has to mention 'hard-cover', issue number 1 or no issue number.
  2. Either year or volume number has to be mentioned and should match.

Examples:

  1. John Constantine, Hellblazer 30th Anniversary Celebration (2018) Hard-Cover.cbr
  2. John Constantine, Hellblazer 30th Anniversary Celebration (2018).cbr
  3. John Constantine, Hellblazer 30th Anniversary Celebration Volume 1.cbr
  4. John Constantine, Hellblazer 30th Anniversary Celebration Volume 1 Issue 01.cbr

Archive Extractions

When extracting files from archives, the files are filtered and deleted if they are not for the volume. A file has to conform with the following rules to pass the filter:

  1. Series title has to match.
  2. Either year or volume number has to be mentioned and should match, or neither should be mentioned.
  3. If it is for a hard cover or one shot, it has to follow the first rule they have for files.
  4. If it is for a TPB, it has to follow the first two rules it has for files.

Search Results for Downloads

When searching for downloads, Kapowarr determines whether the result is a match for the volume or not. The download has to conform with the following rules to be considered a match:

  1. Not be blocklisted.
  2. Series title has to match.
  3. If the volume number is given, it should match.
  4. If the year is given, it should match.
  5. If it is for a hard cover or one shot, it has to follow the first rule they have for files.
  6. If it is for a TPB, it has to follow the first two rules it has for files.
  7. If not a special version, the issue number should match to an issue in the volume.

GetComics Groups

When selecting links from a GetComics download page, Kapowarr filters the groups so that no irrelevant files are downloaded. See the implementation details for more information. The download group has to conform with the following rules to pass the filter:

  1. Series title has to match.
  2. If the volume number is given, it should match.
  3. If the year is given, it should match.
  4. If it is for a hard cover or one shot, it has to follow the first rule they have for files.
  5. If it is for a TPB, it has to follow the first two rules it has for files.