/nhentai-GUI

A GUI for interacting with RicterZ's nhentai CLI tool

Primary LanguagePythonMIT LicenseMIT

nHentai GUI

Please note that nHentai GUI is designed to work alongside RicterZ's nhentai repository.

nHentai GUI is a graphical user interface for interacting with RicterZ's nhentai command-line tool. It provides a more user-friendly way to configure and run nhentai commands without needing to use the command line directly.

Features

  • Configure various download options using checkboxes, input fields, and dropdown menus.
  • Set default options and presets for easy command configuration.
  • Allows for searching and sorting results.
  • Select files to download using .txt files.
  • Interactive interface for managing cookies and user agents.
  • Language selection for content filters.

Requirements

  • Python 3.7+
  • PyQt6 library
  • RicterZ's nhentai repository

Optional

  • Install my fork of the copycookies chrome extension, if you want to make getting cookies easier.

Getting Started

Running with Python

  1. Download and install RicterZ's nhentai repository from here.
  2. Download this repos source code and unzip it.
  3. Install the required Python packages using pip and the requirements.txt file inside the nHentaiGUI folder.
    • pip install -r /path/to/requirements.txt
  4. Run the nhentaiGUI.py file inside nHentaiGUI to start the GUI.

Running the Windows Executable

  1. Download the latest release.
  2. Extract the zip.
  3. Open nhentaiGUI.exe.

Set a Default Directory for Downloads

  • You can set a default folder for all your downloads to go to by going to File -> Options -> Set Default Directory or you can just paste the path in the Output Folder input box as needed.
  • When you have a default folder set, any content entered into the Output Folder box will be appended to the end of your default folder path. This is particularly handy for organizing multiple doujins from the same series into specific subfolders within your default folder.

Set and Update Presets

  • You can create presets for options you frequently use by right clicking anywhere in the title bar and clicking Add preset. You'll be prompted to give the preset a name then click ok. All created presets will be listed under the presets tab in the menu bar.
  • You can update presets with the current options selected by right clicking anywhere in the title bar and clicking Update Preset select the preset you want to update and clicking Update.
  • Currently the only way to delete presets it by opening settings.ini and deleting them manually.

Setting Your Cookies & User-Agent

nHentai GUI provides a Cookie Handler that simplifies setting cookies and user agents. You can use the copycookies extension to export cookies from your browser and use the GUI to set the.

Extension:

  1. Open your browser and navigate to the nhentai website and login.
  2. Use my fork of the copycookies extension to export cookies as JSON data by clicking the copy cookie button added next to the chrome address bar or using the shortcut key Ctrl+Shift+K.
  3. In the nHentai GUI, click File -> Options -> Set Cookie
  4. Paste the exported JSON data into the "Cookie Extension" field and click "Submit."
  5. The cookies and user agent will be set automatically and the window will close itself.

The Old Method:

  1. Use RicterZ's guide to get the cf_clearance cookie and useragent.
  2. In the nHentai GUI, click File -> Options -> Set Cookie
  3. Paste the cf_clearance cookie into the "Cookie" field.
  4. Pase the useragent into the "User-Agent" field and click "Submit."
  5. The cookies and user agent will be set and the window will close itself.

Screenshots

Alt text

Acknowledgements

License

This project is licensed under the MIT License.