Skip to content

Yui007/comix-downloader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎨 Comix Downloader

Python License Platform

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

Fast concurrent downloads • Multiple formats • Scanlator selection

GUI Screenshot


✨ Features

Feature Description
🖥️ Modern GUI Beautiful PyQt6/QML interface with dark theme
🎨 Beautiful CLI Rich terminal interface with progress bars
Concurrent Downloads Multi-threaded chapter and image downloads
📁 Multiple Formats Export as Images, PDF, or CBZ
🎯 Smart Selection Download single, range (1-10), or all chapters
🎨 Scanlator Filter Filter and prefer specific scanlator groups
⚙️ Persistent Settings All preferences saved to config.json

🚀 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

📖 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. Paste a manga URL from comix.to
  2. Click FETCH 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

Setting Description Default
Output Format images / pdf / cbz images
Keep Images Retain images after PDF/CBZ conversion No
Enable Logs Show debug logging No
Download Path Where to save downloads downloads
Max Chapter Workers Concurrent chapter downloads 3
Max Image Workers Concurrent image downloads per chapter 5

📁 Project Structure

comix-downloader/
├── main.py                 # CLI entry point
├── gui/
│   ├── main.py             # GUI entry point
│   ├── bridge/             # Python-QML bridges
│   └── qml/                # QML UI components
├── src/
│   ├── api/comix.py        # API wrapper
│   ├── core/               # Models & downloader
│   ├── formats/            # PDF, CBZ, Images
│   └── cli/                # CLI application
└── config.json             # User settings

🔧 Dependencies

GUI:

  • PyQt6 - Qt6 bindings for Python

CLI:

  • Typer - CLI framework
  • Rich - Beautiful terminal output

Shared:


📜 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!

Releases

No releases published

Packages

No packages published