⚠️ Deprecation Notice ⚠️

This project is now deprecated and no longer actively maintained.
This project has been transitioned to a new and improved version called Perdoo.

Dex-Starr

With test and code of crimson red,
Ripped from a program so freshly dead,
Together with our comics collate,
We'll sort you all, that is your Fate!

Dex-Starr's goal is to help sort and organize your comic collection by using the information stored in Info files.
It also formats all your digital comics into a single format (cbz or cb7), adds and/or updates the supported list of Info files.

Supported Formats

Input Extensions

.cbz
.cbr
.cb7 (Requires installing cb7 dependencies: pip install dex_starr[cb7])
.cbt

Output Extensions

.cbz
.cb7 (Requires installing cb7 dependencies: pip install dex_starr[cb7])

Info Files

Installation

PyPI (Currently not released on PyPI)

Make sure you have Python installed: python --version
Install the project from PyPI: pip install dex_starr

Github

Make sure you have Python installed: python --version
Clone the repo: git clone https://github.com/Buried-In-Code/Dex-Starr
Install the project: pip install .

Execution

Dex-Starr <arguments>

Arguments

Argument	Type	Description
`--manual-edit`	bool	Pause the Script before bundling the files to allow manual removal of Ads, etc...
`--version`	bool	Display the version of Dex-Starr running
`--debug`	bool	Display extra/debug messages while running

Services

Comicvine using the Simyan library.
League of Comic Geeks using the Himon library.
Marvel using the Esak library.
Metron using the Mokkari library.

File Renaming

Series Naming

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

Comic Naming

The files are named based on the format of Comic:

Default/Comic: {Series Title}-#{Issue Number}.cbz
Annual: {Series Title}-Annual-#{Issue Number}.cbz
Digital Chapter: {Series Title}-Chapter-#{Issue Number}.cbz
Hardcover ends with: -HC.cbz
Trade Paperback ends with: -TP.cbz
Graphic Novel ends with: -GN.cbz

Collection Folder Structure

Import
+-- New Comic #10.cbr
+-- New Comic #11.cbz

Collection
+-- Publisher
|  +-- Series
|  |  +-- Series-#1.cbz
|  |  +-- Series-Annual-#1.cbz
|  |  +-- Series-Chapter-#1.cbz
|  |  +-- Series-HC.cbz
|  |  +-- Series-#1-TP.cbz
|  |  +-- Series-GN.cbz
|  +-- Series-v2
|  |  +-- Series-v2-#1.cbz
|  |  +-- Series-v2-Annual-#1.cbz
|  |  +-- Series-v2-Chapter-#1.cbz
|  |  +-- Series-v2-#1-HC.cbz
|  |  +-- Series-v2-TP.cbz
|  |  +-- Series-v2-GN.cbz

Buried-In-Code/Dex-Starr