A doujinshi downloader with ease
Project description
Tomoe 
A doujinshi downloader with ease
Tomoe is a CLI tool for downloading doujinshi from various doujinboards. It's also has built-in auto render into PDF for it's utility, hopefully will be reusable.
Tomoe vs. the doujinboards
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 | Resolved time | Data retrieved |
|---|---|---|---|
nhentai |
 |
~0.52 minutes | ~10.39 MB (26 content) |
pururin |
 |
~0.63 minutes | ~15.55 MB (20 content) |
hentaifox |
 |
~0.33 minutes | ~8.18 MB (26 content) |
hentai2read |
 |
~0.10 minutes | ~7.78 MB (26 content) |
simply-hentai |
 |
~0.29 minutes | ~42.61 MB (19 content) |
qhentai |
 |
~0.65 minutes | ~17.82 MB (30 content) |
asmhentai |
 |
~0.23 minutes | ~4.96 MB (23 content) |
Features
- Plenty of sites coverage
- Built-in auto render into PDF
- Minimalist dependencies
- Download with ease, doesn't require you a lot of arguments
Site support
Currently tomoe support the following websites:
Dependencies
tomoe depends on requests + asyncio, and uses janda for it's doujin library client for Python.
Prerequisites
| NOTE: Python 3.7 or above |
Installation
It's fairly simple to install tomoe
🚀from PyPI
pip install tomoe
🚀from pipenv
pipenv install tomoe
🚀from this repository
Clone this repository, and do python setup.py install
Command usage
tomoe --args <id|path>
Quick example
$ tomoe --nhentai 255369
After that, you could see the download results or throw you an error if something went wrong.
Options
Here are all the options it supports.
| Argument | Description | Example |
|---|---|---|
| --nhentai, int | download from nhentai | tomoe --nhentai 255369 |
| --pururin, int | download from pururin | tomoe --pururin 47226 |
| --hentaifox, int | download from hentaifox | tomoe --hentaifox 59026 |
| --hentai2read, str chapter | download from hentai2read | tomoe --hentai2read chaldea_life 1 |
| --simply, str | download from simply-hentai | tomoe --simply "fate-grand-order/perros" |
| --qhentai, str | download from qhentai | tomoe --qhentai "eight-star-sand" |
| --asmhentai, int | download from asmhentai | tomoe --asmhentai 311851 |
Todo
- Support for bulk download
- Improve image viewer
- Add render to another format support
- Add custom cookie requests
Legal
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
Pronounciation
ja_JP • to-moe — that resembles a comma or the usual form of a magatama.
EoF
All books from those doujinboards are definitely ilegal from original authors.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
