nHentai is a CLI tool for downloading doujinshi from <http://nhentai.net>
-============
-Installation
-============
+===================
+Manual Installation
+===================
.. code-block::
git clone https://github.com/RicterZ/nhentai
cd nhentai
python setup.py install
-
+
+==================
+Installation (pip)
+==================
+Alternatively, install from PyPI with pip:
+
+.. code-block::
+
+ pip install nhentai
+
+For a self-contained installation, use `Pipx <https://github.com/pipxproject/pipx/>`_:
+
+.. code-block::
+
+ pipx install nhentai
+
=====================
Installation (Gentoo)
=====================
nhentai --cookie "YOUR COOKIE FROM nhentai.net"
+**NOTE**: The format of the cookie is `"csrftoken=TOKEN; sessionid=ID"`
+
+| To get csrftoken and sessionid, first login to your nhentai account in web browser, then:
+| (Chrome) |ve| |ld| More tools |ld| Developer tools |ld| Application |ld| Storage |ld| Cookies |ld| https://nhentai.net
+| (Firefox) |hv| |ld| Web Developer |ld| Web Developer Tools |ld| Storage |ld| Cookies |ld| https://nhentai.net
+|
+
+.. |hv| unicode:: U+2630 .. https://www.compart.com/en/unicode/U+2630
+.. |ve| unicode:: U+22EE .. https://www.compart.com/en/unicode/U+22EE
+.. |ld| unicode:: U+2014 .. https://www.compart.com/en/unicode/U+2014
+
Download specified doujinshi:
.. code-block:: bash
nhentai --file=doujinshi.txt
-Search a keyword and download the first page:
-
-.. code-block:: bash
-
- nhentai --search="tomori" --page=1 --download
-
-Download by tag name:
+Set search default language
.. code-block:: bash
- nhentai --tag lolicon --download --page=2
+ nhentai --language=english
-Download by artist name:
-
-.. code-block:: bash
-
- nhentai --artist henreader --download
-
-Download by character name:
-
-.. code-block:: bash
-
- nhentai --character kuro von einsbern --download
-
-Download by parody name:
-
-.. code-block:: bash
-
- nhentai --parody the idolmaster --download
-
-Download by group name:
-
-.. code-block:: bash
-
- nhentai --group clesta --download
-
-Download using multiple tags (--tag, --character, --paordy and --group supported):
+Search a keyword and download the first page:
.. code-block:: bash
- nhentai --tag lolicon, teasing --artist tamano kedama, atte nanakusa
+ nhentai --search="tomori" --page=1 --download
+ # you also can download by tags and multiple keywords
+ nhentai --search="tag:lolicon, artist:henreader, tag:full color"
+ nhentai --search="lolicon, henreader, full color"
Download your favorites with delay:
--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
+ -P --pdf generate PDF file
--rm-origin-dir remove downloaded doujinshi dir when generated CBZ
- file.
+ or PDF file.
# nHentai options
--cookie=COOKIE set cookie of nhentai to bypass Google recaptcha
If you want to use a mirror, you should set up a reverse proxy of `nhentai.net` and `i.nhentai.net`.
For example:
-.. code-block::
+.. code-block::
i.h.loli.club -> i.nhentai.net
h.loli.club -> nhentai.net