A Python CLI tool to search for manga on MangaPill.
Note: Currently the PATH to chromium is set to
/data/data/com.termux/files/usr/bin/chromium-browser- remember to change it to your own PATH. also remember to adjustOUTPUT_DIR = '/storage/emulated/0/Download'to your desired directory.
- 🔍 Search for any manga by name
- 📄 List available chapters
- 📥 Download selected chapters
- 📂 Saves pages in folders like:
Manga Title - Chapter [Number]
Currently they get saved in the following
Androiddirectory: /storage/emulated/0/Download
- 🧠 Handles cookies and lazy-loading via headless Chromium
~ $ python mangapill
Enter manga name to search: alya
Searching...
Search results:
1. Tokidoki Bosotto Russia-go de Dereru Tonari no Aalya-san
Choose manga number: 1
Fetching chapters for 'Tokidoki Bosotto Russia-go de Dereru Tonari no Aalya-san'...
Available chapters:
1. Chapter 60
2. Chapter 59
3. Chapter 58
4. Chapter 57
5. Chapter 56
6. Chapter 55
7. Chapter 54
...more chapters here...
Enter chapters to download (e.g. 1,3,5-7 or 'all'): 60
Downloading chapter Chapter 1 ...
[✓] Saved Tokidoki Bosotto Russia-go de Dereru Tonari no Aalya-san - Chapter 1/page_1.jpg
[✓] Saved Tokidoki Bosotto Russia-go de Dereru Tonari no Aalya-san - Chapter 1/page_2.jpg
[✓] Saved Tokidoki Bosotto Russia-go de Dereru Tonari no Aalya-san - Chapter 1/page_3.jpg
[✓] Saved Tokidoki Bosotto Russia-go de Dereru Tonari no Aalya-san - Chapter 1/page_4.jpg
...more downloads here...
- Python 3.8+
- Chromium (or Chrome) installed
- Termux
pip install -r requirements.txt
⚙️ Setup (Termux Example)
- Install Chromium:
pkg install chromium
- Edit the script to set your Chromium path:
EX:
CHROMIUM_PATH = '/data/data/com.termux/files/usr/bin/chromium-browser'
- Run the script:
python3 Mangapill.py
or:
python Mangapill.py
- Add input validation and error handling (e.g., invalid chapter numbers)
- Add support for selecting multiple chapters by range (e.g.,
1-5,8) - Add download progress bars using
rich - Auto-create a master folder for all manga
- Add option to rename downloaded images (e.g.,
001.jpg,002.jpg) - Add chapter metadata (e.g., title, date) in a
info.jsonor.txt - Create a command-line executable wrapper (e.g.,
mangadl) - Add support for bulk downloads (all chapters at once)
- Add support for converting chapters to PDF or CBZ
- Optional GUI or TUI mode (using
textualortkinter) - Track download history and prevent duplicates
- Add scraping support for other manga sites (e.g., MangaDex, Manganelo) Check out this repo!
- Support manga with multiple translations (language selector)
Feel free to post issues! 🔧