Skip to main content

Unify and organize your comic collection.

Project description

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!

PyPI - Python PyPI - Status PyPI - Version PyPI - License

Hatch Pre-Commit Black isort Flake8

Github - Contributors Github Action - Code Analysis Github Action - Testing Github Action - Publishing

Dex-Starr helps sort and organize your comic collection by using the information stored in ComicInfo 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.
Dex-Starr can also pull information from a list of sources to populate missing fields.

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)

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

Github

  1. Make sure you have Python installed: python --version
  2. Clone the repo: git clone https://github.com/Buried-In-Code/Dex-Starr
  3. 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...
--resolve-manually bool Manually choose which fields are chosen by the importer

Services

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: {Series Title}-#{Issue Number}.cbz
  • Annual: {Series Title}-Annual-#{Issue Number}.cbz
  • Digital Chapter: {Series Title}-Chapter-#{Issue Number}.cbz
  • Hardcover (If it is a numbered issue): {Series Title}-#{Issue Number}-HC.cbz
  • Hardcover (If it is not a numbered issue): {Series Title}-{Issue Title}-HC.cbz
  • Trade Paperback (If it is a numbered issue): {Series Title}-#{Issue Number}-TP.cbz
  • Trade Paperback (If it is not a numbered issue): {Series Title}-{Issue Title}-TP.cbz
  • Graphic Novel: {Series Title}-{Issue Title}.cbz

Collection Folder Structure

Root Folder
+-- Import
|  +-- New Comic #10.cbr
|  +-- New Comic #11.cbz
+-- Processing
+-- Collection
|  +-- Publisher
|  |  +-- Series
|  |  |  +-- Series-#1.cbz
|  |  |  +-- Series-Annual-#1.cbz
|  |  |  +-- Series-Chapter-#1.cbz
|  |  |  +-- Series-#1-HC.cbz
|  |  |  +-- Series-Title-HC.cbz
|  |  |  +-- Series-#1-TP.cbz
|  |  |  +-- Series-Title-TP.cbz
|  |  |  +-- Series-Title.cbz
|  |  +-- Series-v2
|  |  |  +-- Series-v2-#1.cbz
|  |  |  +-- Series-v2-Annual-#1.cbz
|  |  |  +-- Series-v2-Chapter-#1.cbz
|  |  |  +-- Series-v2-#1-HC.cbz
|  |  |  +-- Series-v2-Title-HC.cbz
|  |  |  +-- Series-v2-#1-TP.cbz
|  |  |  +-- Series-v2-Title-TP.cbz
|  |  |  +-- Series-v2-Title.cbz

Socials

Social - Discord

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dex_starr-0.0.1.tar.gz (21.4 kB view hashes)

Uploaded Source

Built Distribution

dex_starr-0.0.1-py3-none-any.whl (15.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page