semvec/pypi-packages huggingface dataset:
hanimetvdl 0.0.1
Hanime.tv cli dl
Requires Python: <4.0,>=3.10

# hanimetvdl
CLI tool for downloading hentai from hanime.tv
## Installation
Install `ffmpeg` with whatever package manager you use, then run `pip install hanimetvdl`.
## CLI Usage
```
usage: htv [-h] [--tags TAGS [TAGS ...]] [--broad-tag-match] [--blacklist BLACKLIST [BLACKLIST ...]] [--company COMPANY [COMPANY ...]] [--page PAGE] [--sort-by SORT_BY] [--sort-order SORT_ORDER] [--roll-search] [--resolution RESOLUTION] [--index INDEX [INDEX ...]] [--all] [--folder] [--franchise] [--url] [--metadata] [--verbose] [video ...]

positional arguments:
  video                 Video URL or search term

optional arguments:
  -h, --help            show this help message and exit
  --tags TAGS [TAGS ...], -t TAGS [TAGS ...]
                        Tags to search for
  --broad-tag-match     Match videos including any tags specified by --tags
  --blacklist BLACKLIST [BLACKLIST ...], -b BLACKLIST [BLACKLIST ...]
                        Blacklisted tags
  --company COMPANY [COMPANY ...], -c COMPANY [COMPANY ...]
                        Companies/brands to filter by
  --page PAGE, -p PAGE  Page # of search results
  --sort-by SORT_BY, -s SORT_BY
                        Sorting method for search results ([u]pload, [v]iews, [l]ikes, [r]elease, [t]itle)
  --sort-order SORT_ORDER, -w SORT_ORDER
                        Order of sorting ([a]scending or [d]escending)
  --roll-search, -R     Roll all search pages into one long page, useful for large-volume downloads
  --resolution RESOLUTION, -r RESOLUTION
                        Resolution of download, default 1080
  --index INDEX [INDEX ...], -i INDEX [INDEX ...]
                        Index of search results to download
  --all, -a             Download all search results in page
  --folder, -F          Create folders by franchise when downloading
  --franchise, -f       Download the video and all other videos in its franchise
  --url, -u             Show urls of the source video, do not download
  --metadata, -m        Show metadata of the source video, do not download
  --verbose, -v         Enable verbose logging for video download
```
There are some special search terms you can use.
 - `htv ALL` - Shows all results matching filters
 - `htv random` - Random list of hentai
 - `htv new-uploads` - Shows the newest uploads
 - `htv new-releases` - Shows the newest releases
## FAQ
 - Can this download 1080p videos without Premium?

Not anymore. This utility used to be able to do this, but a breaking API change caused this functionality to stop working.
 - How do I download all videos matching a filter?

`htv ALL -R -a <FILTER>` will do this.
Some examples:

Download all videos from a brand:

`htv ALL -R -a -c "<BRAND>"`

Download all videos matching a particular tag: 

`htv ALL -R -a -t "<TAG>"`
 - When I search for brand or tag XYZ, it shows empty search results
 
 If you are using tag, company, or blacklist filtering for search, you will need to make sure that the filters have quotes around them and are spelled correctly.
 
 Example: `htv ALL -c majin label` will show empty search results, but `htv ALL -c "magin label"` will show the correct results.