Skip to main content

📚 Bato.to Manga Downloader

PyPI Python PyQt6 License

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

Search, browse, and download your favorite manga with ease

GUI Screenshot


✨ 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
PyQt6 Modern GUI framework
Typer CLI framework
Rich Beautiful terminal output
Requests HTTP requests
Pillow 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!

Metadata

Release files for bato-downloader 7.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bato-downloader 7.3
File Size Uploaded
bato_downloader-7.3.tar.gz 33.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for bato-downloader 7.3
File Interpreter ABI Platform
bato_downloader-7.3-py3-none-any.whl Python 3 none any Details

Total release size: 76.9 kB

Release files / bato_downloader-7.3.tar.gz

Download URL bato_downloader-7.3.tar.gz
Size 33.9 kB
Tags Source
SHA-256 checksum
How to use checksums
d02f7d53501751f17990a05964dbae72ac4b4d0054b204271b01a683ba60573f
BLAKE2b-256 checksum
How to use checksums
07eda5c63039d509f0338b0c0e2ed10c0a7aefea51867561b98449e3d009e110
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.6

Release files / bato_downloader-7.3-py3-none-any.whl

Download URL bato_downloader-7.3-py3-none-any.whl
Size 43.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0ebc5329081dc12d362d91c5d8750e5cac28f12b1bcbc5e6c30401b5ec72d3dc
BLAKE2b-256 checksum
How to use checksums
30a0e1ad403f9c3afa797fb1a2bd331c4073fc6b1f4e385db0abc3c918db8008
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.6

Release history Release notifications | RSS feed

This release

7.3 This release

2 release files

7.2

2 release files

7.1

2 release files

7.0.0

2 release files

6.0.0

2 release files

5.1

2 release files

5.0

2 release files

4.5

2 release files

4.1

2 release files

4.0

2 release files

3.0

2 release files

2.0

2 release files

1.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page