📚 Bato.to Manga Downloader
Beautiful manga downloader for xbat.tv (formerly bato.to)
Search, browse, and download your favorite manga with ease
✨ Features
🚀 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
- 🔍 Search - Enter manga name and press Search
- 👆 Select - Click a result card to view details
- ☑️ Choose - Select chapters you want to download
- 📥 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_chaptersin settings (try 1-2) - Reduce
concurrent_imagesin settings - Check if the site is accessible
❌ Invalid URL error
- URL must contain
batoorxbatand/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)
| File | Size | Uploaded | |
|---|---|---|---|
| bato_downloader-7.3.tar.gz | 33.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|