Skip to main content doujinshis downloader

Project description

       _   _            _        _
 _ __ | | | | ___ _ __ | |_ __ _(_)
| '_ \| |_| |/ _ \ '_ \| __/ _` | |
| | | |  _  |  __/ | | | || (_| | |
|_| |_|_| |_|\___|_| |_|\__\__,_|_|

あなたも変態。 いいね?

travis pypi license

nHentai is a CLI tool for downloading doujinshi from <>


git clone
cd nhentai
python install

Installation (Gentoo)

layman -fa glicOne
sudo emerge net-misc/nhentai


IMPORTANT: To bypass the nhentai frequency limit, you should use –cookie option to store your cookie.

The default download folder will be the path where you run the command (CLI path).

Set your nhentai cookie against captcha:

nhentai --cookie "YOUR COOKIE FROM"

Download specified doujinshi:

nhentai --id=123855,123866

Download doujinshi with ids specified in a file (doujinshi ids split by line):

nhentai --file=doujinshi.txt

Search a keyword and download the first page:

nhentai --search="tomori" --page=1 --download

Download by tag name:

nhentai --tag lolicon --download --page=2

Download by language:

nhentai --language english --download --page=2

Download by artist name:

nhentai --artist henreader --download

Download by character name:

nhentai --character "kuro von einsbern" --download

Download by parody name:

nhentai --parody "the idolmaster" --download

Download by group name:

nhentai --group clesta --download

Download using multiple tags (–tag, –character, –paordy and –group supported):

nhentai --tag "lolicon, teasing" --artist "tamano kedama, atte nanakusa"

Download your favorites with delay:

nhentai --favorites --download --delay 1

Format output doujinshi folder name:

nhentai --id 261100 --format '[%i]%s'

Supported doujinshi folder formatter:

  • %i: Doujinshi id
  • %t: Doujinshi name
  • %s: Doujinshi subtitle (translated name)
  • %a: Doujinshi authors’ name

Other options:

  # Operation options
  -h, --help            show this help message and exit
  -D, --download        download doujinshi (for search results)
  -S, --show            just show the doujinshi information

  # Doujinshi options
  --id=ID               doujinshi ids set, e.g. 1,2,3
  -s KEYWORD, --search=KEYWORD
                        search doujinshi by keyword
  --tag=TAG             download doujinshi by tag
  -F, --favorites       list or download your favorites.

  # Multi-page options
  --page=PAGE           page number of search results
  --max-page=MAX_PAGE   The max page when recursive download tagged doujinshi

  # Download options
  -o OUTPUT_DIR, --output=OUTPUT_DIR
                        output dir
  -t THREADS, --threads=THREADS
                        thread count for downloading doujinshi
  -T TIMEOUT, --timeout=TIMEOUT
                        timeout for downloading doujinshi
  -d DELAY, --delay=DELAY
                        slow down between downloading every doujinshi
  -p PROXY, --proxy=PROXY
                        uses a proxy, for example:
  -f FILE, --file=FILE  read gallery IDs from file.
  --format=NAME_FORMAT  format the saved folder name

  # Generating options
  --html                generate a html viewer at current directory
  --no-html             don't generate HTML after downloading
  --gen-main            generate a main viewer contain all the doujin in the folder
  -C, --cbz             generate Comic Book CBZ File
  --rm-origin-dir       remove downloaded doujinshi dir when generated CBZ

  # nHentai options
  --cookie=COOKIE       set cookie of nhentai to bypass Google recaptcha

nHentai Mirror

If you want to use a mirror, you should set up a reverse proxy of and For example: -> ->

Set NHENTAI env var to your nhentai mirror.

NHENTAI= nhentai --id 123456
nhentai nhentai nhentai



Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for nhentai, version 0.3.9
Filename, size File type Python version Upload date Hashes
Filename, size nhentai-0.3.9.tar.gz (23.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page