Beautiful manga downloader for xbat.tv (formerly bato.to)
Search, browse, and download your favorite manga with ease
|
|
|
|
# Install from PyPI
pip install bato-downloader
# Launch GUI
bato-downloader-gui
# Launch CLI
bato-downloader✅ That's it! All dependencies are installed automatically.
| Platform | GUI | CLI |
|---|---|---|
| Windows | 📥 BatoDownloaderGUI.exe | 📥 BatoDownloaderCLI.exe |
Just download and run - no Python needed!
| 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 |
- 🔍 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
╭────────────────────────────────────────╮
│ 📚 BATO DOWNLOADER 📚 │
╰────────────────────────────────────────╯
Main Menu
[1] 📥 Download Manga by URL
[2] 🔍 Search For Manga
[3] ⚙️ Settings
[4] 🚪 Exit
Select option [1/2/3/4]:
# 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"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 |
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
| Package | Purpose |
|---|---|
| Modern GUI framework | |
| CLI framework | |
| Beautiful terminal output | |
| HTTP requests | |
| Image processing |
🖼️ 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# 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# Build GUI only
.\build_gui.bat
# Build CLI only
.\build_cli.bat
# Build both at once
.\build_all.batOutput:
dist/
├── BatoDownloaderGUI.exe # 🖼️ Windowed application
└── BatoDownloaderCLI.exe # 💻 Console application
This project is licensed under the MIT License
Made with ❤️ by Yui007
⭐ Star this repo if you find it useful!