X-Git-Url: https://git.lizzy.rs/?a=blobdiff_plain;f=README.rst;h=cf0497ab2e143152a72481c3410573226eb9aa38;hb=bdc9fa113e9fb5fabbb47837cc033763edd6321a;hp=fbba1f3116ce86bb183db397054c2e1203e1a50b;hpb=f3141d572654aa85cc0861ef351f5a87602606fe;p=nhentai.git diff --git a/README.rst b/README.rst index fbba1f3..cf0497a 100644 --- a/README.rst +++ b/README.rst @@ -1,87 +1,209 @@ -nhentai -======= - -.. code-block:: - _ _ _ _ - _ __ | | | | ___ _ __ | |_ __ _(_) - | '_ \| |_| |/ _ \ '_ \| __/ _` | | - | | | | _ | __/ | | | || (_| | | - |_| |_|_| |_|\___|_| |_|\__\__,_|_| - - -あなたも変態。 いいね? -[![Build Status](https://travis-ci.org/RicterZ/nhentai.svg?branch=master)](https://travis-ci.org/RicterZ/nhentai) ![nhentai PyPI Downloads](https://img.shields.io/pypi/dm/nhentai.svg) [![license](https://img.shields.io/cocoapods/l/AFNetworking.svg)](https://github.com/RicterZ/nhentai/blob/master/LICENSE) - - -nHentai is a CLI tool for downloading doujinshi from [nhentai.net](http://nhentai.net). - -### Installation - - git clone https://github.com/RicterZ/nhentai - cd nhentai - python setup.py install - -### Installation (Gentoo) - - layman -fa glicOne - sudo emerge net-misc/nhentai - -### Usage -**IMPORTANT**: To bypass the nhentai frequency limit, you should use `--login` option to log into nhentai.net. - -*The default download folder will be the path where you run the command (CLI path).* - -Download specified doujinshi: - -.. code-block:: bash - nhentai --id=123855,123866 - -Download doujinshi with ids specified in a file: - -.. 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 your favourite doujinshi (login required): - -.. code-block:: bash - nhentai --login "username:password" --download - -Download by tag name: - -.. code-block:: bash - nhentai --tag lolicon --download - -### Options - -+ `-t, --thread`: Download threads, max: 10 -+ `--output`:Output dir of saving doujinshi -+ `--tag`:Download by tag name -+ `--timeout`: Timeout of downloading each image -+ `--proxy`: Use proxy, example: http://127.0.0.1:8080/ -+ `--login`: username:password pair of your nhentai account -+ `--nohtml`: Do not generate HTML -+ `--cbz`: Generate Comic Book CBZ File - -### 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: - - i.h.loli.club -> i.nhentai.net - h.loli.club -> nhentai.net - -Set `NHENTAI` env var to your nhentai mirror. - -.. code-block:: bash - NHENTAI=http://h.loli.club nhentai --id 123456 - -![](./images/search.png) -![](./images/download.png) -![](./images/viewer.png) - -### あなたも変態 -![](./images/image.jpg) +nhentai +======= + +.. code-block:: + + _ _ _ _ + _ __ | | | | ___ _ __ | |_ __ _(_) + | '_ \| |_| |/ _ \ '_ \| __/ _` | | + | | | | _ | __/ | | | || (_| | | + |_| |_|_| |_|\___|_| |_|\__\__,_|_| + + +あなたも変態。 いいね? + +|travis| +|pypi| +|license| + + +nHentai is a CLI tool for downloading doujinshi from + +=================== +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 `_: + +.. code-block:: + + pipx install nhentai + +===================== +Installation (Gentoo) +===================== +.. code-block:: + + layman -fa glicOne + sudo emerge net-misc/nhentai + +===== +Usage +===== +**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: + +.. code-block:: bash + + nhentai --cookie "YOUR COOKIE FROM nhentai.net" + +**NOTE**: The format of the cookie is `"csrftoken=TOKEN; sessionid=ID"` + +Download specified doujinshi: + +.. code-block:: bash + + nhentai --id=123855,123866 + +Download doujinshi with ids specified in a file (doujinshi ids split by line): + +.. code-block:: bash + + nhentai --file=doujinshi.txt + +Set search default language + +.. code-block:: bash + + nhentai --language=english + +Search a keyword and download the first page: + +.. code-block:: bash + + 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: + +.. code-block:: bash + + nhentai --favorites --download --delay 1 + +Format output doujinshi folder name: + +.. code-block:: bash + + 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: + +.. code-block:: + + 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: http://127.0.0.1:1080 + -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 + -P --pdf generate PDF file + --rm-origin-dir remove downloaded doujinshi dir when generated CBZ + or PDF file. + + # 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 `nhentai.net` and `i.nhentai.net`. +For example: + +.. code-block:: + + i.h.loli.club -> i.nhentai.net + h.loli.club -> nhentai.net + +Set `NHENTAI` env var to your nhentai mirror. + +.. code-block:: bash + + NHENTAI=http://h.loli.club nhentai --id 123456 + + +.. image:: ./images/search.png?raw=true + :alt: nhentai + :align: center +.. image:: ./images/download.png?raw=true + :alt: nhentai + :align: center +.. image:: ./images/viewer.png?raw=true + :alt: nhentai + :align: center + +============ +あなたも変態 +============ +.. image:: ./images/image.jpg?raw=true + :alt: nhentai + :align: center + + + +.. |travis| image:: https://travis-ci.org/RicterZ/nhentai.svg?branch=master + :target: https://travis-ci.org/RicterZ/nhentai + +.. |pypi| image:: https://img.shields.io/pypi/dm/nhentai.svg + :target: https://pypi.org/project/nhentai/ + +.. |license| image:: https://img.shields.io/github/license/ricterz/nhentai.svg + :target: https://github.com/RicterZ/nhentai/blob/master/LICENSE