🚀 MangaForge

🎯 Beautiful Python CLI Manga Downloader

Plugin-based architecture supporting multiple manga sources with a gorgeous Rich-based interface

_{Inspired by mangal but built in Python with modern architecture}

---

✨ Features

🎨 Beautiful CLI	🔌 Plugin System	⚡ High Performance	📦 Multiple Formats
Rich-based interface	Auto-discover providers	Parallel downloads	CBZ, PDF, Images
Interactive menus	Drop-in architecture	Concurrent processing	Live progress bars
Paginated tables	No core modifications	Smart rate limiting	Beautiful output

🌟 Current Providers

Provider	Status	Description
Bato 🟢	✅ Fully Working	Popular manga hosting with clean interface
WeebCentral 🟢	✅ Fully Working	High-quality manga scans
MangaPark 🟢	✅ Fully Working	Large manga library
MangaBuddy 🟢	✅ Fully Working	Fast and reliable source
AsuraComic 🟢	✅ Fully Working	Premium manga hosting
WebToons 🟢	✅ Fully Working	Premium webtoon hosting
MangaKakalot 🟢	✅ Fully Working	Large manga library
VyManga 🟢	✅ Fully Working	Premium manga and webtoon hosting
Toonily 🟢	✅ Fully Working	SFW/NSFW webtoon and Manhwa hosting
KaliScan 🟢	✅ Fully Working	High-quality manga hosting with modern interface
ManhuaScan 🟢	✅ Fully Working	Rich manhua Library hosting

🟢 Fully Tested | 🟡 Basic Testing | ⚪ In Development

More providers coming soon!

🚀 Quick Start

1. Clone & Setup

git clone https://github.com/Yui007/MangaForge.git
cd MangaForge

# Create virtual environment (recommended)
python -m venv venv
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

2. Launch CLI

python main.py

3. Search & Download

1. Search: Choose "[1] 🔍 Search Manga by Title"
2. Select Provider: Pick from 11 available sources
3. Browse Results: Navigate paginated results
4. Download: Select chapters and format (CBZ/PDF/Images)

---

📖 Usage Examples

Search for Manga

# Launch CLI
python main.py

# Select: [1] Search Manga by Title
# Choose provider: Bato, WeebCentral, etc.
# Enter: "attack on titan"
# Browse results and select manga

Download by URL

# Select: [2] Get Manga by URL
# Enter manga URL from any supported provider
# Auto-detect provider and fetch chapters

Configuration

# Select: [3] Settings
# Configure:
# - Download directory
# - Parallel workers
# - Output format (CBZ/PDF/Images)
# - Network timeout

---

🏗️ Architecture

MangaForge/
├── 🧠 core/              # Core system (locked)
│   ├── base_provider.py  # Provider interface
│   ├── downloader.py     # Parallel downloads
│   ├── converter.py      # Format conversion
│   └── config.py         # Settings management
├── 📊 models/           # Data structures
├── 🔌 providers/        # Plugin providers
│   ├── bato.py         # Bato provider ✅
│   ├── weebcentral.py  # WeebCentral ✅
│   ├── mangapark.py    # MangaPark ✅
│   ├── mangabuddy.py   # MangaBuddy ✅
│   ├── asuracomic.py   # AsuraComic ✅
│   ├── webtoons.py     # Webtoons ✅
│   ├── mangakakalot.py # MangaKakalot ✅
│   ├── vymanga.py      # VyManga ✅
│   ├── toonily.py      # Toonily ✅
│   ├── kaliscan.py     # KaliScan ✅
│   └── manhuascan.py   # ManhuaScan ✅
├── 🎨 cli/              # Beautiful interface
├── ⚙️ config/           # Settings
└── 📥 downloads/        # Downloaded manga

🔧 Advanced Features

Provider System

• 🔌 Plugin Architecture: Add providers without touching core code
• 🔍 Auto-Discovery: Drop .py files in providers/ folder
• 🛡️ Error Handling: Robust failure recovery
• ⚡ Performance: Optimized scraping and parsing

Download System

• 🔄 Parallel Processing: Configurable workers for chapters
• 📈 Live Progress: Real-time progress bars
• 🔁 Resume Support: Continue interrupted downloads
• 📊 Smart Queuing: Efficient resource utilization

Output Formats

• 📚 CBZ: Comic book archive (ZIP format)
• 📄 PDF: Portable document format
• 🖼️ Images: Individual image files
• 🎯 Quality Control: Configurable image processing

---

🛠️ Development

Adding New Providers

Create a new file in providers/:

from core.base_provider import BaseProvider
from models import MangaSearchResult, MangaInfo, Chapter

class NewProvider(BaseProvider):
    provider_id = "newprovider"
    provider_name = "New Provider"
    base_url = "https://newprovider.com"

    def search(self, query: str, page: int = 1):
        # Implement search logic
        pass

    def get_manga_info(self, manga_id: str = None, url: str = None):
        # Implement manga info extraction
        pass

    def get_chapters(self, manga_id: str):
        # Implement chapter listing
        pass

    def get_chapter_images(self, chapter_id: str):
        # Implement image extraction
        pass

✨ Auto-discovered! No core modifications needed.

Running Tests

# Core system tests
python test_core_system.py

# CLI system tests
python test_cli_system.py

# All tests
python test.py

---

📋 Requirements

• Python: 3.10 or higher
• Dependencies: See requirements.txt
• Optional: Playwright browsers for some providers

Virtual Environment Setup

# Create virtual environment
python -m venv venv

# Activate (Windows)
venv\Scripts\activate

# Activate (macOS/Linux)
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Deactivate when done
deactivate

---

🌟 Comparison with Similar Projects

Feature	MangaForge	mangal
Language	Python 🐍	Go 🏃
Interface	Rich CLI 🎨	TUI
Providers	11+ (growing) 📈	10+
Architecture	Plugin-based 🔌	Built-in
Customization	YAML config ⚙️	CLI flags
Output Formats	CBZ, PDF, Images 📦	CBZ only

MangaForge brings the mangal experience to Python with:

• 🎨 Beautiful Rich-based CLI
• 🔌 True plugin architecture
• ⚙️ Flexible configuration
• 📦 Multiple output formats

---

🤝 Contributing

Contributions are welcome! Here's how to help:

🚀 Quick Start for Contributors

# Fork and clone
git clone https://github.com/YOUR_USERNAME/MangaForge.git
cd MangaForge

# Setup development environment
python -m venv venv
source venv/bin/activate  # or venv\Scripts\activate on Windows
pip install -r requirements.txt

# Run tests
python test.py

# Launch CLI
python main.py

📝 Adding Providers

1. Create provider file in providers/
2. Implement 4 methods: search(), get_manga_info(), get_chapters(), get_chapter_images()
3. Test thoroughly with real data
4. Submit PR with provider name and description

🐛 Reporting Issues

• 🐛 Bugs: Use GitHub Issues with detailed error logs
• 💡 Features: Create feature requests with use cases
• 📖 Docs: Help improve documentation

---

📄 License

MIT License - See LICENSE file for details.

---

🎯 Ready to Download Manga?

# Quick setup
git clone https://github.com/Yui007/MangaForge.git
cd MangaForge
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python main.py

🌟 Enjoy your manga collection!