Perdoo

Perdoo is designed to assist in sorting and organizing your comic collection by utilizing metadata files stored within comic archives.
Perdoo standardizes all your digital comics into a unified format (cb7, cbt, or cbz).
It adds and/or updates metadata files using supported services.
Unlike other tagging tools, Perdoo employs a manual approach when metadata files are absent, prompting users to enter the necessary Publisher/Series/Issue details for search purposes.

Installation

Pipx

1. Ensure you have Pipx installed: pipx --version
2. Install the project: pipx install perdoo

Usage

Perdoo Commands

Perdoo import

Perdoo archive Commands

Perdoo archive view

Perdoo settings Commands

Perdoo settings view

Perdoo settings locate

Perdoo settings update

Supported Formats

Input Extensions

• .cbr
• .cbt
• .cbz
• .cb7

Output Extensions

• .cbt
• .cbz (Default)
• .cb7

Metadata Files

• MetronInfo.xml
• Perdoo supports a slightly modified ComicInfo.xml to ignore field ordering.

Services

• Comicvine using the Simyan library.
• Marvel using the Esak library.
• Metron using the Mokkari library.

File Organization

Series Naming

Series with a volume greater than 1 will display its volume in the title.

Comic Naming

The files are named based on the format of the comic:

• Default: {Series Title}_#{Issue Number}.cbz
• Annual: {Series Title}_Annual_#{Issue Number}.cbz
• Digital Chapter: {Series Title}_Chapter_#{Issue Number}.cbz
• Graphic Novel: {Series Title}_#{Issue Number}_GN.cbz
• Hardcover: {Series Title}_#{Issue Number}_HC.cbz
• Omnibus: {Series Title}_#{Issue Number}.cbz
• Trade Paperback: {Series Title}_#{Issue Number}_TPB.cbz

Folder Structure

Collection Root
+-- Publisher
|  +-- Series
|  |  +-- Series_#001.cbz
|  |  +-- Series_Annual_#01.cbz
|  |  +-- Series_Chapter_#01.cbz
|  |  +-- Series_#01_GN.cbz
|  |  +-- Series_#01_HC.cbz
|  |  +-- Series_#01_TPB.cbz
|  +-- Series-v2
|  |  +-- Series-v2_#001.cbz
|  |  +-- Series-v2_Annual_#01.cbz
|  |  +-- Series-v2_Chapter_#01.cbz
|  |  +-- Series-v2_#01_GN.cbz
|  |  +-- Series-v2_#01_HC.cbz
|  |  +-- Series-v2_#01_TPB.cbz

Socials