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 yt-dlp/yt-dlp#3810 and #8

The issue is with yt-dlp's HLS fragment downloader, and a well-known fix is adding the --downloader ffmpeg option.

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

yt-dlp has a policy against piracy sites; 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, following the instructions for your operating system, because otherwise it would not work.