hanime-plugin

This yt-dlp plugin adds support for numerous hentai websites, including but not limited to hanime.tv, hstream.moe and HentaiHaven.

Installation

You can install this package with pip:

pip install --user hanime-plugin

Warning

If a bug is fixed or a feature is added, but not released on PyPI yet, do this instead:

pip install "git+https://github.com/cynthia2006/hanime-plugin.git"

See installing yt-dlp plugins for other methods of installation.

Deno

hanime.tv extractor requires a JavaScript runtime. As of now, Deno is supported. Install it with these commands, and it would be available in PATH if you follow the onscreen instructions carefully.

# For Linux & MacOS
curl -fsSL https://deno.land/install.sh | sh
# For Windows (PowerShell)
irm https://deno.land/install.ps1 | iex

Support

The following is the support matrix of sites and the respective video resolutions offered. To request support for a site, or complain about a broken site, please open a Github issue.

	720p	1080p	4K
hstream.moe	✅	✅ †	❌
oppai.stream	✅	✅ ‡	✅ ‡
hentaihaven.com	✅ ‡	✅ ‡	❌
hanime.tv	✅	❌*	❌
ohentai.org	✅	❌	❌
hentaimama.io	✅	❌	❌
hanime.red	❌	✅	❌

* Requires paid membership, and is beyond the scope of this plugin.

† AV1 codec. ‡ VP9 codec.

Examples

Downloading a single video

$ yt-dlp https://hanime.tv/videos/hentai/fuzzy-lips-1

or

$ yt-dlp -f - https://hentaihaven.com/video/soshite-watashi-wa-sensei-ni/episode-1

FAQ

ERROR: Data must be padded to 16 byte boundary in CBC mode

See https://github.com/yt-dlp/yt-dlp/issues/3810 and #8

CBC mode is related to AES used to encrypt HLS streams. Since AES is a symmetric block cipher operating on 128-bit (16 byte) blocks, data is required to align to 16-bit block boundaries for successful decryption. The issue is with yt-dlp's AES decryption routines that does not add PKCS7 padding to ciphertext whose padding has been stripped, and the underlying library pycryptodomex's AES.decrypt() method expects padded data. A workaround is to use the --downloader ffmpeg option.

$ yt-dlp --download-ffmpeg https://hanime.tv/videos/hentai/fuzzy-lips-1

Why support for these sites aren't added to yt-dlp?

yt-dlp has a policy against piracy sites, and hentai sites belong to that category. The original extractor for hanime.tv was a separate tool, unmaintained since 2021. I raised a feature request, but it was declined. I had maintained a fork of yt-dlp with a hanime.tv extractor adapted from the original code, before I lost access to that account. This plugin had initially been based off of that. Support for other sites have been added in late 2025.

Why doesn't the hanime.tv extractor work?

Please make sure Deno is installed, and the install directory (folder) is in PATH. If it's not, add it. See this for Windows. And, Linux? If you're unable to add a location to PATH, what sort of a Linux user are you?