Tomoe is a CLI tool for downloading doujinshi from various doujinboards. It's also has built-in modular bulk downloads, and has auto render into PDF (Portable Document Format) for it's utility, hopefully will be reusable.
🚀 Commands • Documentation • Report Issues
Tomoe consumes Jandapress and uses janda for the doujin Python library.
Features availability Speed or perfomace may not accurate because internet connection or API response. Some tests has high resolve time and rendering a bit longer, because some source does not providing real extension of a images, tomoe should check and guessing it's format.
| Site | Status | Bulk download | Average response | Downloaded |
|---|---|---|---|---|
nhentai |
 |
Yes |
~0.52 minutes | ~10.39 MB (26 images) |
pururin |
 |
Yes |
~0.63 minutes | ~15.55 MB (20 images) |
hentaifox |
 |
Yes |
~0.33 minutes | ~8.18 MB (26 images) |
hentai2read |
 |
Yes |
~0.10 minutes | ~7.78 MB (26 images) |
simply-hentai |
 |
Yes |
~0.29 minutes | ~42.61 MB (19 images) |
asmhentai |
 |
Yes |
~0.23 minutes | ~4.96 MB (23 images) |
- Plenty of sites coverage
- Built-in auto render into PDF
- Modular bulk downloads
- Minimalist dependencies
- Download with ease, doesn't require you a lot of arguments
Currently tomoe support the following websites:
| NOTE: Python 3.7 or above |
pip install tomoe / pipenv install tomoe
- Or manual build by cloning the repository and running
python setup.py install
tomoe --args <id|path>
tomoe --nhentai 177013
After that, you could see the download results or throw you an error if something went wrong.
It's fairly simple to use tomoe
| Argument | Description | Example |
|---|---|---|
| --nhentai, int | nhentai | tomoe --nhentai 255369 |
| --pururin, int | pururin | tomoe --pururin 47226 |
| --hentaifox, int | hentaifox | tomoe --hentaifox 59026 |
| --hentai2read, str chapter:number | hentai2read | tomoe --hentai2read chaldea_life:1 |
| --simply, str | simply-hentai | tomoe --simply "fate-grand-order/fgo-no-ashibon-fgo-foot-book/all-pages" |
| --asmhentai, int | asmhentai | tomoe --asmhentai 311851 |
You can passing multiple id to requests bulk download
| Sites | Description | Example |
|---|---|---|
| nhentai | place multiple id | tomoe --nhentai 255369 417103 417119 |
| pururin | place multiple id | tomoe --pururin 47226 64351 56175 |
| hentaifox | place multiple id | tomoe --hentaifox 59026 61805 |
| hentai2read | place multiple chapter:number |
tomoe --hentai2read chaldea_life:1 watashitachi_producersan_ni_mechakucha:1 |
| simply | place multiple chapter | tomoe --simply "fate-grand-order/fgo-no-ashibon-fgo-foot-book/all-pages" "original-work/kanchou-manga-cffc37a/all-pages" |
| asmhentai | place multiple id | tomoe --asmhentai 311851 210135 309068 |
tomoe --bulk doujin.json
Since this tool covers plenty of website, If You need to download from each multiple different website You can make bulk download with arbitrary methods, Meant you can mix and wrap the whole book id into nested array in a JSON file. Read more about Understanding Nested Arrays.
Create doujin.json in the same directory You want to run tomoe and follow this structure:
Note You should not change the "book" property
{
"book": [
{
"nhentai": 177013
},
{
"nhentai": 255369
},
{
"pururin": 47226
},
{
"pururin": 64351
},
{
"hentaifox": 59026
},
{
"hentaifox": 61805
},
{
"asmhentai": 311851
},
{
"asmhentai": 210135
},
{
"hentai2read": "chaldea_life:1"
},
{
"simply": "fate-grand-order/fgo-no-ashibon-fgo-foot-book/all-pages"
}
]
}Then tells tomoe to resolve all the book id from the JSON file.
tomoe --bulk doujin.json
This tool can be freely copied, modified, altered, distributed without any attribution whatsoever. However, if you feel like this tool deserves an attribution, mention it. It won't hurt anybody.
Licence: WTF.
ja_JP • to-moe — commonly translated as "comma", is a comma-like swirl symbol used in Japanese mon. It closely resembles the usual form of a magatama.
All books from those third-party doujinboards are definitely ilegal from original authors. Support the authors by buying the original book.
