🎨 Comix Downloader

A beautiful manga downloader for comix.to with GUI & CLI

Fast concurrent downloads • Multiple formats • Scanlator selection

🚀 Looking for the browser extension? Check out the Comix Browser Extension!

✨ Features

🚀 Installation

Prerequisites

• Python 3.10 or higher
• pip (Python package manager)

Quick Start

# Clone the repository
git clone https://github.com/Yui007/comix-downloader.git
cd comix-downloader

# Install dependencies
pip install -r requirements.txt

# Install Chrome browser (nodriver handles driver download automatically)

📖 Usage

GUI Mode (Recommended)

# Run with GPU rendering (default)
python gui/main.py

# Run with CPU/Software rendering (for compatibility)
python gui/main.py --cpu

1. Search for a manga title in the Browse screen, or paste a manga URL from comix.to
2. Select a discovery result (or click FETCH for a URL) to load manga info and chapters
3. Select chapters and choose scanlator preference/filter
4. Click DOWNLOAD CHAPTERS
5. Access ⚙️ Settings to configure format, output path, workers

CLI Mode

# Interactive mode
python main.py

# Direct download
python main.py download "https://comix.to/title/abc-manga-name" -c "1-10" -f cbz

⚙️ Settings

Settings are stored in the platform user configuration directory so CLI and GUI launches use the same values regardless of the current working directory. The legacy root and gui/config.json files are imported once and left intact.

📁 Project Structure

comix-downloader/
├── main.py                 # CLI entry point
├── gui/
│   ├── main.py             # GUI entry point
│   ├── bridge/             # Python-QML bridges (downloads, details, discovery)
│   └── qml/                # QML UI components
├── src/
│   ├── api/comix.py        # API wrapper
│   ├── core/               # Models & downloader
│   ├── formats/            # PDF, CBZ, Images
│   ├── cli/                # CLI application
│   └── utils/              # Config, logging, session, compatibility helpers
├── tests/                  # Unit tests
└── config.json             # Legacy settings imported on first run

🔧 Dependencies

GUI: - PyQt6 - Qt6 bindings for Python

CLI: - Typer - CLI framework - Rich - Beautiful terminal output

Shared: - nodriver - Browser automation and canvas image extraction - Requests - HTTP library - Pillow - Image processing - ReportLab - PDF generation

Note: The app includes a small compatibility shim for a nodriver 0.50.3 source-encoding issue on Python 3.14. No manual edits inside site-packages are required.

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

⚠️ Disclaimer

This tool is for personal use only. Please respect the copyright of manga authors and publishers. Support official releases when available.

Made with ❤️ by Yui007

⭐ Star this repo if you find it useful!