hpkg1

CLI downloader for amateursubs.com — direct MP4 with parallel chunk download.

Install

pip install hpkg1

Usage

hpkg1                          # interactive fuzzy search picker
hpkg1 -s "kokuhaku"            # pre-filter by title
hpkg1 -s "title" --all         # download all files non-interactively
hpkg1 -q 1080p                 # only download 1080p files
hpkg1 -q best                  # best quality per episode (default)
hpkg1 -q all                   # every available quality
hpkg1 --refresh-index          # force-refresh the post list
hpkg1 --config                 # show current settings
hpkg1 --set-download-dir ~/dl  # change download directory
hpkg1 --set-threads 16         # change parallel threads
hpkg1 --set-quality 1080p      # change default quality
hpkg1 --version                # print version

How it works

1. Loads all posts from WordPress REST API → local cache (~/.hpkg1_index.json)
2. InquirerPy fuzzy picker to select a title
3. Extracts direct MP4 URLs from post content:
   • Strategy 1: WP REST API content.rendered (fast)
   • Strategy 2: HTML scrape fallback (handles Presto Player posts)
   • Strategy 3: ouo.io link resolver — bypasses monetized redirect links (~65% of posts use these)
4. Downloads with parallel Range requests for full bandwidth utilisation
5. Resume-safe: chunks are stored in ~/.hpkg1_chunks/ keyed by URL hash — re-run to continue an interrupted download exactly where it left off

Config

Config stored at ~/.hpkg1.json:

Quality options

Flags reference