bato-downloader 7.1

A beautiful manga downloader for Bato.to with PyQt6 GUI and Rich CLI

📚 Bato.to Manga Downloader

Beautiful manga downloader for xbat.tv (formerly bato.to)

Search, browse, and download your favorite manga with ease

---

✨ Features

🔍 Smart Search Search by manga title Card-based results with covers Authors, genres & ratings display Pagination support	📥 Powerful Downloads Concurrent chapter downloads Parallel image fetching Progress tracking Resume support
📁 Multiple Formats Images - Raw image files PDF - Single file per chapter CBZ - Comic book archive	🎨 Two Interfaces GUI - Beautiful PyQt6 interface CLI - Interactive Rich terminal

---

🚀 Installation

Option 1: Install from PyPI (Recommended)

# Install from PyPI
pip install bato-downloader

# Launch GUI
bato-downloader-gui

# Launch CLI
bato-downloader

✅ That's it! All dependencies are installed automatically.

Option 2: Download Executables

Platform	GUI	CLI
Windows	📥 BatoDownloaderGUI.exe	📥 BatoDownloaderCLI.exe

Just download and run - no Python needed!

---

🖥️ Graphical User Interface

Search	Manga Details	Settings
Search by title	View chapters	Configure downloads
Cover previews	Select multiple	Set output format
One-click select	Download progress	Adjust concurrency

How to Use

1. 🔍 Search - Enter manga name and press Search
2. 👆 Select - Click a result card to view details
3. ☑️ Choose - Select chapters you want to download
4. 📥 Download - Click "Download Selected" and wait

---

💻 Command-Line Interface

╭────────────────────────────────────────╮
│       📚 BATO DOWNLOADER 📚            │
╰────────────────────────────────────────╯

Main Menu

  [1] 📥 Download Manga by URL
  [2] 🔍 Search For Manga
  [3] ⚙️  Settings
  [4] 🚪 Exit

Select option [1/2/3/4]:

Direct Commands

# Interactive mode
bato-downloader

# Search for manga
bato-downloader search "Solo Leveling"

# Download from URL
bato-downloader download "https://xbat.tv/title/81514-solo-leveling"

---

⚙️ Configuration

Settings are saved in config.json:

Setting	Options	Default
📁 download_format	images / pdf / cbz	images
📂 output_directory	Any path	Current folder
⚡ concurrent_chapters	1-10	3
🖼️ concurrent_images	1-20	5
💾 keep_images_after_conversion	true / false	true

---

📁 Project Structure

bato_downloader/
├── 🚀 main.py              # GUI entry point
├── 🖥️ cli.py               # CLI entry point
├── 📁 gui/
│   ├── main_window.py      # Main window
│   ├── workers.py          # Background threads
│   ├── styles.py           # Theme & colors
│   └── widgets/            # UI components
├── 📁 src/
│   ├── config.py           # Settings
│   ├── scraper/            # Web scraping
│   └── downloader/         # Download logic
├── 🔧 build_gui.bat        # Build GUI
├── 🔧 build_cli.bat        # Build CLI
└── 🔧 build_all.bat        # Build both

---

📦 Dependencies

Package	Purpose
	Modern GUI framework
	CLI framework
	Beautiful terminal output
	HTTP requests
	Image processing

---

❓ Troubleshooting

🖼️ Cover images not loading

• Check your internet connection
• Covers load asynchronously, wait a moment
• Try refreshing the search

⏱️ Download timeouts

• Reduce concurrent_chapters in settings (try 1-2)
• Reduce concurrent_images in settings
• Check if the site is accessible

❌ Invalid URL error

• URL must contain bato or xbat and /title/
• Example: https://xbat.tv/title/81514-solo-leveling

📄 PDF conversion fails

pip install Pillow --upgrade

---

🛠️ Development

Install from Source

# Clone the repository
git clone https://github.com/Yui007/bato_downloader.git
cd bato_downloader

# Install in development mode
pip install -e .

# Run directly
bato-downloader      # CLI
bato-downloader-gui  # GUI

# Or run scripts directly
python cli.py
python main.py

Building Executables

# Build GUI only
.\build_gui.bat

# Build CLI only
.\build_cli.bat

# Build both at once
.\build_all.bat

Output:

dist/
├── BatoDownloaderGUI.exe   # 🖼️ Windowed application
└── BatoDownloaderCLI.exe   # 💻 Console application

---

📜 License

This project is licensed under the MIT License

Made with ❤️ by Yui007

⭐ Star this repo if you find it useful!