ComicOrganizer 📚

A Python tool for organizing comics, manga, and digital archives into a clean, iPad-reader-friendly library structure.

Architecture

/Volumes/qb/downloads/default/     (SOURCE - download dir)
  ├── Boruto - Two Blue Vortex (Digital) (1r0n)/  → CBZ chapters + volumes
  ├── Weekly Viz, ShonenJump and MangaPlus.../     → 106 manga series (CBZ)
  ├── Weekly Shonen Jump 2026 .../                  → ZIP magazines
  ├── Mitori Fujii/                                 → EPUB manga
  ├── colección yaoi bara.rar                       → 2.3GB RAR (12k+ images)
  └── Naruto (2002)/                                → Anime video (skipped)

/Volumes/500g-R1/Comics and Books/Comics/  (DESTINATION - organized library)
  ├── Manga/
  │   ├── <Series>/
  │   │   ├── Chapters/
  │   │   │   └── <Series> - Chapter NNNN (Year) (Digital, Source).cbz
  │   │   └── Volumes/
  │   │       └── <Series> - Volume NN (Year) (Digital, Source).cbz
  │   └── Mitori Fujii/
  │       └── Mitori Fujii - <Title>.epub
  ├── Magazines/
  │   └── Weekly Shonen Jump (週刊少年ジャンプ)/
  │       └── Weekly Shonen Jump - YYYY Issue NN.cbz
  └── Collections/
      └── Bara Collection/
          ├── AUTORES 1/ ... AUTORES 4/  (by artist)
          ├── MIX BARA/
          └── VARIOS/

Quick Start

cd ~/Claude\ Scripts\ and\ Venvs/ComicOrganizer
source venv/bin/activate