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 details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

Details for the file dex_starr-0.0.1.tar.gz.

File metadata

  • Download URL: dex_starr-0.0.1.tar.gz
  • Upload date:
  • Size: 21.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.0

File hashes

Hashes for dex_starr-0.0.1.tar.gz
Algorithm Hash digest
SHA256 d8b0cdd0e51eb99b9b0e0c4cfa09593adcbb8db82c7bf825a3bfbf11dcfe7296
MD5 1934e7dd231a72fecf48a8baa83e4c9a
BLAKE2b-256 5bc2ddc684e0068e8f099c1a304f97e02c5c55b66bf6c43c98bd9c45aeafd6b3

See more details on using hashes here.

File details

Details for the file dex_starr-0.0.1-py3-none-any.whl.

File metadata

  • Download URL: dex_starr-0.0.1-py3-none-any.whl
  • Upload date:
  • Size: 15.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.0

File hashes

Hashes for dex_starr-0.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b83690b61fb08dc78ad7538626c3f1356ccf599465973143a04ce47bff1a2b75
MD5 50e7eec782bb97431bd5baedbe133662
BLAKE2b-256 fc8453431a47a63f5571e3f3579e2ef75eac19525c55877d37f716962cf90b39

See more details on using hashes here.

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