This yt-dlp plugin adds support for the hanime.tv extractor.

History

This extractor was first founded by rxqv, as a separate tool. A prime feature of that tool was the ability to search and download all videos in a hentai series.

xsbee, who also made an issue on yt-dlp repo, took on the apparently stale rxqv repo, converting it into a yt-dlp extractor.

This repository takes the extractor code and makes it a plugin, which makes maintainence rather easier. And does a few more additions.

Installation

Requires yt-dlp 2023.07.06 or above.

You can install this package with pip:

python3 -m pip install hanime-tv-plugin

Or, with pipx:

pipx install hanime-tv-plugin

See installing yt-dlp plugins for the other methods this plugin package can be installed.

Features

• Video downloads upto 720p (1080p requires premium membership).

• Playlist downloads (public & unlisted without cookies.txt). If you need to download private playlists, you have to extract cookies off hanime.tv while still being logged in. Use this extension and download the cookies.txt in the current working directory.

• Franchise downloads. To download all videos in a franchise --extractor-args "hanimetv:franchise=1" must be passed to yt-dlp commandline. A franchise is collection of OVAs (or simply, episodes) in a certain Hentai OVA series.

Examples

• To download a single video

  yt-dlp "https://hanime.tv/hentai/video/green-eyes-ane-kyun-yori-1"
  

• To download a playlist

  yt-dlp "https://hanime.tv/playlists/liked-videos-bsqnpuefi9la"
  

• To download all the videos in a franchise

  yt-dlp --extractor-args "hanimetv:franchise=1" "https://hanime.tv/hentai/video/resort-boin-uncensored-re-release-1"
  

Search

xsbee had also made a search script to search without the web interface. It is included in the plugin package, and can be invoked through htv-search.

usage: htv-search [-h] [-q QUERY] [-b BRAND] [-t TAG] [-T TAG] [-o {title,views,likes,upload_date,release_date}] [-p PAGE]
                  [--ascending] [--broad-search] [--verbose]

options:
  -h, --help            show this help message and exit
  -q QUERY, --query QUERY
                        text to search with
  -b BRAND, --brand BRAND
                        search for videos produced by a company/brand
  -t TAG, --tag TAG     search for videos having a tag
  -T TAG, --no-tag TAG  search for videos not having a tag
  -o {title,views,likes,upload_date,release_date}, --order {title,views,likes,upload_date,release_date}
                        property to sort results by
  -p PAGE, --page PAGE  page number to show
  --ascending           show results in ascending order
  --broad-search        use broad search for whitelist of tags
  --verbose             show details about a result

Total pages and result count will be displayed

A few usecases include the following.

• Simple text query

  $ htv-search "kanojo x kanojo x kanojo"
  Kanojo x Kanojo x Kanojo 3: https://hanime.tv/hentai/video/kanojo-x-kanojo-x-kanojo-3
  Kanojo x Kanojo x Kanojo 2: https://hanime.tv/hentai/video/kanojo-x-kanojo-x-kanojo-2
  Kanojo x Kanojo x Kanojo 1: https://hanime.tv/hentai/video/kanojo-x-kanojo-x-kanojo-1
  ---
  Page 1 of 1, Results 3
  

• With multiple tags

  $ htv-search -t harem -t 'big boobs' -t x-ray -t uncensored -T 'ugly bastard'
  Shoujo-tachi no Sadism 2: https://hanime.tv/hentai/video/shoujo-tachi-no-sadism-2
  Shoujo-tachi no Sadism 1: https://hanime.tv/hentai/video/shoujo-tachi-no-sadism
  Ikenai Koto The Animation 1: https://hanime.tv/hentai/video/ikenai-koto-the-animation-1
  Yubisaki Annainin 2: https://hanime.tv/hentai/video/yubisaki-annainin-2
  Yubisaki Annainin 1: https://hanime.tv/hentai/video/yubisaki-annainin-1
  ---
  Page 1 of 1, Results 5