]> git.lizzy.rs Git - nhentai.git/blobdiff - README.rst
use dict.update to update config values
[nhentai.git] / README.rst
index 94c1625720d4f256a35a154c062b618de869c508..cf0497ab2e143152a72481c3410573226eb9aa38 100644 (file)
@@ -19,15 +19,30 @@ nhentai
 
 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)
 =====================
@@ -50,6 +65,8 @@ Set your nhentai cookie against captcha:
 
     nhentai --cookie "YOUR COOKIE FROM nhentai.net"
 
+**NOTE**: The format of the cookie is `"csrftoken=TOKEN; sessionid=ID"`
+
 Download specified doujinshi:
 
 .. code-block:: bash
@@ -62,39 +79,20 @@ 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:
+Set search default language
 
 .. code-block:: bash
 
-    nhentai --search="tomori" --page=1 --download
-
-Download by tag name:
-
-.. code-block:: bash
+    nhentai --language=english
 
-    nhentai --tag lolicon --download --page=2
-
-.. code-block:: bash
-
-    nhentai --artist henreader --download
-
-.. code-block:: bash
-
-    nhentai --character kuro von einsbern --download
-
-.. code-block:: bash
-
-    nhentai --parody the idolmaster --download
-
-.. code-block:: bash
-
-    nhentai --group clesta --download
-
-Download with 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:
 
@@ -154,9 +152,11 @@ Other options:
       # 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
+      -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
@@ -168,7 +168,7 @@ nHentai Mirror
 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