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 (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 archive Commands

Perdoo settings Commands

Supported Formats

Input Extensions

• .cbr
• .cbt
• .cbz
• .cb7 (Requires installing cb7 dependencies: pipx install perdoo[cb7])

Output Extensions

• .cbz

Metadata Files

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

Services

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

File Renaming and Organization

File naming and organization uses a pattern-based approach, it tries to name based on the MetronInfo data with a fallback to ComicInfo. Naming is done based on the Comic Format, set the value to "" and it will fallback to the default setting.

• Default: {publisher-name}/{series-name}-v{volume}/{series-name}-v{volume}_#{number:3}
• Annual: {publisher-name}/{series-name}-v{volume}/{series-name}-v{volume}_Annual_#{number:2}
• Digital Chapter: {publisher-name}/{series-name}-v{volume}/{series-name}-v{volume}_Chapter_#{number:3}
• Graphic Novel: {publisher-name}/{series-name}-v{volume}/{series-name}-v{volume}_GN_#{number:2}
• Hardcover: {publisher-name}/{series-name}-v{volume}/{series-name}-v{volume}_HC_#{number:2}
• Limited Series: "" Falls back to Default
• Omnibus: {publisher-name}/{series-name}-v{volume}/{series-name}-v{volume}_OB_#{number:2}
• One-Shot: "" Falls back to Default
• Single Issue: "" Falls back to Default
• Trade Paperback: {publisher-name}/{series-name}-v{volume}/{series-name}-v{volume}_TPB_#{number:2}

Options

• Padding: Int and Int-like fields, such as {number}, can include optional zero-padding by specifying the length (e.g. {number:3} will pad 0's to be atleast 3 digits long, 12 => 012).
• Sanitization: All metadata values are sanitized to remove characters outside the set 0-9a-zA-Z&!-. Custom characters can still be added directly to patterns.

Settings

To set Perdoo setting details, update the file: ~/.config/perdoo/settings.toml. File will be created on first run.

Example File

[output]
folder = "~/.local/share/perdoo"
format = "cbz"

[output.comic_info]
create = true
handle_pages = true

[output.metron_info]
create = true

[output.naming]
seperator = "-"
default = "{publisher-name}/{series-name}-v{volume}/{series-name}-v{volume}_#{number:3}"
annual = ""
digital_chapter = ""
graphic_novel = ""
hardcover = ""
limited_series = ""
omnibus = ""
one_shot = ""
single_issue = ""
trade_paperback = ""

[services]
order = ["Metron", "Comicvine"]

[services.comicvine]
api_key = "<Comicvine API Key>"

[services.metron]
username = "<Metron Username>"
password = "<Metron Password>"

Details

• output.folder The folder where the output files will be stored. Defaults to ~/.local/share/perdoo.

• output.format The output file format for the comic archives. Defaults to cbz.

• output.comic_info.create Whether to create a ComicInfo.xml file in the output archive. Defaults to true.

• output.comic_info.handle_pages Whether to handle page data in the ComicInfo.xml file. Defaults to true.

• output.metron_info.create Whether to create a MetronInfo.xml file in the output archive. Defaults to true.

• output.naming.seperator The word separator used in the output file names. Defaults to -. Options are -, _, ., or (space).

• output.naming.* The naming patterns for different comic formats. Each pattern can be customized or left empty to use the default setting. The patterns support various metadata fields as described in the above "File Renaming and Organization" section.

• services.order The order in which the services will be used for metadata retrieval. Metadata will be fetched from the first service that returns a result. Don't include the service name in the list if you don't want to use it. Defaults to ["Metron", "Comicvine"], options are Metron and Comicvine.

Socials