nhentai-tools 1.0.0

A python library that allows you to interact with nhentai.net without API key (unofficial)

nhentai tools

Unofficial Python library for interacting with nhentai.net without API key.

Installation

pip install nhentai_tools

nhentai tools requires python >= 3.9

Basic Usage

Download gallery by ID

from nhentai_tools import download

# Download gallery in gallery folder and embed metadata
download(1337, path="gallery", metadata=True)
# Downloaded files can be found in gallery/

Mass download by tag, character, artist or parody

from nhentai_tools import artist_download, character_download, tag_download, parody_download

# Download all galleries from artist and embed metadata
artist_download("coolsigma", metadata=True)
# Downloaded files can be found in coolsigma/

# Download all galleries with specified character and embed metadata
character_download("JetStream-Sam", metadata=True)
# Downloaded files can be found in JetStream-Sam/

The library has more mass download functions, please refer to Downloading

Working with metadata

from nhentai_tools import extract_metadata, embed_metadata

# Extract metadata, return it as dict and save to "meta" variable
meta = extract_metadata(1337)

# Write metadata in metadata.txt file
embed_metadata(meta, path="metadata")
# File can be found in metadata/metadata.txt

Documentation

Full documentation can be found on Wiki

Building

# Required for building
pip install build

git clone https://github.com/minimalcorruption/nhentai_tools
cd nhentai_tools
python -m build

# Installing from local build
pip install .

Important

This project is in beta, bugs are expected
If something goes wrong, please open an issue