https://github.com/buried-in-code/perdoo
Perdoo's goal is to help sort and organize your comic collection by using the information stored in metadata files inside the comic archives.
https://github.com/buried-in-code/perdoo
comic-info comics comicvine-api command-line marvel-api metadata metron-api metron-info python-3 tagger xml
Last synced: 4 months ago
JSON representation
Perdoo's goal is to help sort and organize your comic collection by using the information stored in metadata files inside the comic archives.
- Host: GitHub
- URL: https://github.com/buried-in-code/perdoo
- Owner: Buried-In-Code
- License: mit
- Created: 2024-03-14T20:14:43.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-10T08:47:23.000Z (over 1 year ago)
- Last Synced: 2024-10-16T22:45:42.767Z (over 1 year ago)
- Topics: comic-info, comics, comicvine-api, command-line, marvel-api, metadata, metron-api, metron-info, python-3, tagger, xml
- Language: Python
- Homepage:
- Size: 210 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Perdoo
[](https://pypi.python.org/pypi/Perdoo/)
[](https://pypi.python.org/pypi/Perdoo/)
[](https://pypi.python.org/pypi/Perdoo/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/pre-commit/pre-commit)
[](https://github.com/astral-sh/ruff)
[](https://github.com/Buried-In-Code/Perdoo/graphs/contributors)
[](https://github.com/Buried-In-Code/Perdoo/actions/workflows/testing.yaml)
[](https://github.com/Buried-In-Code/Perdoo/actions/workflows/publishing.yaml)
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](https://pipx.pypa.io/stable/) 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
## Supported Formats
### Input Extensions
- .cbr
- .cbt
- .cbz
- .cb7 _(Requires installing `cb7` dependencies: `pipx install perdoo[cb7]`)_
### Output Extensions
- .cbz
### Metadata Files
- [MetronInfo.xml](https://github.com/Metron-Project/metroninfo)
- Perdoo supports a slightly modified [ComicInfo.xml](https://github.com/anansi-project/comicinfo) to ignore field ordering.
## Services
- [Comicvine](https://comicvine.gamespot.com) using the [Simyan](https://github.com/Metron-Project/Simyan) library.
- [Marvel](https://www.marvel.com/comics) using the [Esak](https://github.com/Metron-Project/Esak) library.
- [Metron](https://metron.cloud) using the [Mokkari](https://github.com/Metron-Project/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.
| Pattern Key | Description |
| -------------------- | ------------------------------------------------------ |
| `{cover-date}` | The issue cover date in `yyyy-mm-dd` format. |
| `{cover-day}` | The day from the issue cover date. |
| `{cover-month}` | The month from the issue cover date. |
| `{cover-year}` | The year from the issue cover date. |
| `{format}` | The full format name of the series. |
| `{id}` | The primary id of the issue. |
| `{imprint}` | The publisher's imprint. |
| `{isbn}` | The issue's ISBN. |
| `{issue-count}` | The total number of issues in the series. |
| `{lang}` | The issue's language. |
| `{number}` | The issue number. |
| `{publisher-id}` | The publisher's unique id. |
| `{publisher-name}` | The full name of the publisher. |
| `{series-id}` | The series' unique id. |
| `{series-name}` | The full name of the series. |
| `{series-sort-name}` | Sort-friendly name (omits leading "The", "A", etc...). |
| `{series-year}` | The year the series started. |
| `{store-date}` | The store date of the issue in `yyyy-mm-dd` format. |
| `{store-day}` | The day from the issue store date. |
| `{store-month}` | The month from the issue store date. |
| `{store-year}` | The year from the issue store date. |
| `{title}` | The issue title. |
| `{upc}` | The issue's UPC. |
| `{volume}` | The volume of the series. |
## Settings
To set Perdoo setting details, update the file: `~/.config/perdoo/settings.toml`.
File will be created on first run.
### Example File
```toml
[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", "Marvel", "Comicvine"]
[services.comicvine]
api_key = ""
[services.marvel]
public_key = ""
private_key = ""
[services.metron]
username = ""
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", "Marvel", "Comicvine"]`, options are `Metron`, `Marvel` and `Comicvine`.
## Socials
[](https://fosstodon.org/@BuriedInCode)\
[](https://matrix.to/#/#The-Dev-Environment:matrix.org)