A beautiful manga downloader for comix.to with GUI & CLI
Fast concurrent downloads • Multiple formats • Scanlator selection
| 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 |
- Python 3.10 or higher
- pip (Python package manager)
# Clone the repository
git clone https://github.com/Yui007/comix-downloader.git
cd comix-downloader
# Install dependencies
pip install -r requirements.txtSince comix.to employs Cloudflare protection, it is highly recommended to run FlareSolverr alongside this downloader to avoid 403 Forbidden errors.
- Download the latest version of FlareSolverr from: FlareSolverr Releases
- Extract the archive and run the executable (
flaresolverr.exeon Windows). - Keep it running in the background. The downloader automatically detects it at
http://localhost:8191/v1and will bypass Cloudflare challenges seamlessly.
# Run with GPU rendering (default)
python gui/main.py
# Run with CPU/Software rendering (for compatibility)
python gui/main.py --cpu- Paste a manga URL from comix.to
- Click FETCH to load manga info and chapters
- Select chapters and choose scanlator preference/filter
- Click DOWNLOAD CHAPTERS
- Access ⚙️ Settings to configure format, output path, workers
# Interactive mode
python main.py
# Direct download
python main.py download "https://comix.to/title/abc-manga-name" -c "1-10" -f cbz| 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 |
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
GUI:
- PyQt6 - Qt6 bindings for Python
CLI:
Shared:
This project is licensed under the MIT License - see the LICENSE file for details.
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!