hpo 🐯

The Hare Download, Game & Media Manager — a Kung Fu Panda + Dragon Knight + Rooster Fighter + The Wild Robot themed CLI multitool written in Hare.

• HTTP/HTTPS/FTP via curl with a dragon-themed progress bar
• Magnet links via aria2c
• Google Drive via gdown (multi-library aware)
• Mega via megadl
• Rooster links — share any URL encrypted with AES-256-CBC; only the right code unlocks it
• Suno music with auto MP3 conversion
• Rate limiting, resume, custom User-Agent, cookies, tokens

• hpo tailung <url1> <url2> <url3> ...
• Breaks out and fires all downloads at once — true parallel execution
• Reports how many succeeded / failed when the dust settles

hpo --lock https://example.com/secret.zip --code "skadoosh123"
# -> rooster:?xt=AES256:U2FsdGVkX1...
hpo "rooster:?xt=AES256:U2FsdGVkX1..." --code "skadoosh123"

Works with HTTP, Google Drive, and magnet links alike — the encrypted token is safe to share publicly.

• Epic Games via legendary + Zhen engine (Linux) or PowerShell bridge (WSL)
• Steam / Foxfire via URI handler + Zhen GE-Proton (Linux) or PowerShell bridge (WSL)
• hpo --steam list — shows installed games with names + AppIDs (works on WSL too)
• Launch shows the full game name, looked up from Steam's manifests
• Per-game aliases in ~/.config/hpo/{steam,epic}_aliases.txt
• Steam-native games: appids in ~/.config/hpo/steam_requires_native.txt launch via the Steam client (for games needing steamclient, e.g. GDK titles)

• Self-contained gaming runtime built on umu-launcher + GE-Proton11-1
• Auto-symlinks GE-Proton into Steam's compatibilitytools.d
• Install: hpo --zhen-setup --proton
• Update: hpo --zhen-update
• On WSL: bridges Steam/Epic to Windows via PowerShell Start-Process

• hpo monkey — launches Rocket League via Epic (legendary) + umu + GE-Proton11-1
• Handles Easy Anti-Cheat (EAC) through umu's EGS protonfixes
• hpo monkey setup — install Rocket League

• hpo bnet — launches Battle.net (and WoW) via Zhen + umu
• DRM-safe launch flags for a stable Blizzard login

• hpo viper — PS5/PS4 Remote Play via chiaki-ng (Flatpak)
• Stream your own console over the network

• hpo ping — launches Roblox via Sober (Flatpak)

Master Croc racks the ball! — a TUI menu of 10 open-source retro games.

• hpo croc — open the arcade menu, pick a game
• hpo croc setup — install all 10 games via Flatpak (with progress)

The lineup (all free / open-source):

1. 🎯 Space Cadet Pinball
2. 🧱 LBreakout HD (Breakout)
3. 🚀 OpenTyrian (vertical shooter)
4. 🫧 Frozen Bubble (puzzle)
5. 🦕 Nanosaur (3D dino shooter)
6. 🦔 Sonic Robo Blast 2 (3D platformer)
7. 🏁 SRB2 Kart (racing)
8. 🗡️ Shattered Pixel Dungeon (roguelike)
9. 🍄 SuperTux (platformer)
10. 🏎️ SuperTuxKart (racing)

• hpo xp <system> <game> — multi-system retro arcade
• Systems: NES, SNES, Genesis (via MAME), Game Boy (mGBA), PSX (DuckStation)
• Earn Piyokocoin as you play
• Legal note: works with your own game dumps, homebrew, and free MAME ROMs only

Play your Game Boy through 3DS collection (Turning Red themed).

• hpo redpanda — browse & launch GB/GBC/GBA/NDS/3DS ROMs from your own dumps
• Auto-picks emulator: mGBA (GB/GBC/GBA), melonDS (NDS), Azahar (3DS)
• Supports .zip and .7z (auto-extract to per-game cache)
• Costs 2 PYO per play
• ROMs live in ~/.local/share/hpo/arcade/{gb,gbc,gba,nds,3ds}/

The clever macaque thief serves your movies! — stream your films to any device on your network.

• hpo rukhmini — serve ~/Videos on port 8377
• hpo rukhmini <folder> — serve a specific folder
• OMDb movie posters — real posters fetched by title (cached)
• Network streaming — open the shown IP on your phone or TV
• Range requests — seeking and mobile playback work smoothly
• Size filter — hides small disc-rip clips (menus, trailers), shows real films
• Custom macaque logo in the web header
• Architecture: Hare launches it, Node.js streams the video, JS/HTML is the frontend, OMDb supplies posters
• OMDb key lives in ~/.config/hpo/omdb_key.txt (free key from omdbapi.com — never committed)

Elegant and soaring — Crane plays music from anywhere.

• hpo crane <file> — play a local track directly
• hpo crane repeat <file> — 🔁 loop a track until you're done
• hpo crane mix <path> — 🔀 DJ mode: shuffle + loop your collection
• hpo crane local <path> — play a local folder (Suno tracks, downloads)
• hpo crane search <words> — SoundCloud search
• hpo crane radio <words> — SoundCloud radio (10 tracks in a row)
• hpo crane yt <words> — YouTube search
• hpo crane ytradio <words> — YouTube radio (10 tracks)
• hpo crane web <words> — open SoundCloud search in your browser
• Playback controls (via mpv): p/space = pause, +/- = volume, q = quit
• Respects DRM — skips protected tracks (plays only freely available music)

"Take his chi!" — Kai makes your anime jade-sharp.

• hpo kai <file> — play a local anime/video with Anime4K upscaling
• hpo kai <folder> — play a whole folder
• hpo kai <youtube-url> — YouTube in 1080p + Anime4K (downloads then plays to avoid HLS 403)
• hpo kai <search words> — search YouTube and play
• Perfect for your own anime Blu-rays (rip with MakeMKV → jade-sharp playback)
• Anime4K v4.0 shaders (MIT) in ~/.config/mpv/shaders/, tuned for 1080p

• hpo mantis — a themed TUI hub for tracking manga carts
• Keep your reading list and shopping carts in one place

• Live schedules for 90+ Danish cinemas via bio.ebillet.dk
• Day filter: idag, imorgen, weekday names, weekend, uge
• Fuzzy match — suggests the nearest cinema if you mistype
• Custom ASCII portrait via ~/.config/hpo/art/shifu.txt

The memory wizard preserves your hpo setup — back up and restore your whole setup to a USB, perfect for distro-hopping.

• hpo akna save <usb-dir> — save config + art + game list to akna-hpo-backup.tar.gz
• hpo akna save-all <usb-dir> — also include your manga carts
• hpo akna restore <usb-dir> — restore config on a new system
• hpo akna restore-all <usb-dir> — restore config + manga carts
• hpo akna list <usb-dir> — show what a backup contains
• Bundles aliases, keys, art portraits, Piyokocoin balance, and a snapshot of installed games

"Your power... is now MINE!" — The Chameleon steals (backs up) and restores your game saves.

• hpo chameleon backup <alias> — back up a Steam Cloud save
• hpo chameleon backup --epic <alias> — back up an Epic Cloud save
• hpo chameleon list — show all saves with names + dates
• hpo chameleon restore <alias> — restore the latest backup
• Auto-prune: keeps only the newest backup per game
• Saves stored in ~/hpo-saves/

• hpo tigress — a daily dose of motivation from Master Tigress
• Same quote all day, changes at midnight

• hpo piyoko — show your Piyokocoin balance with 8-bit coin art
• Earn Piyokocoin automatically: 1 per download, 3 per Rooster link (premium), 1 per file in Tai Lung batches
• hpo piyoko spin, hpo piyoko cook, hpo piyoko cookbook, hpo piyoko recipe <n>
• Balance stored in ~/.config/hpo/piyokocoin

Elegant and merciless driver manager (Rooster Fighter themed).

• hpo elizabeth — inspect GPU, printer, audio, network, Flatpak drivers
• hpo elizabeth install — install missing drivers (Vulkan, CUPS, Flatpak)
• hpo elizabeth backup / hpo elizabeth restore — save/view driver setup
• "Your machine will be flawless."

• Guided meditation with Master Oogway quotes and a breathing bar
• hpo oogway 60 (1 min), hpo oogway 300 (5 min)
• Real monastery bell via mpv (~/.local/share/hpo/bell.mp3)

• Auto-locates via ip-api.com, weather from Open-Meteo (no API keys)
• City override: hpo roz vejr københavn, hpo roz vejr sydney
• Poetic, Wild-Robot-themed descriptions; full Unicode (ø, æ, å)

• hpo doctor — system health check (verifies tools & backends)
• hpo --setup — install everything (apt + pip + Zhen + emulators)
• install.sh — beginner-friendly bootstrap (builds Hare + hpo from scratch)

• Hare compiler (harec, qbe) — built/tested on Hare 0.26.0
• curl, aria2c, openssl, xdg-open for download backends
• gdown (pip install gdown) for Google Drive
• mpv for the Oogway bell, Crane music, and Kai video
• node for the Rukhmini movie server
• python3 for the Shifu cinema helper
• legendary (pipx install legendary-gl) for Epic Games on Linux
• yt-dlp for Crane/Kai YouTube support
• flatpak for Croc arcade games, Viper, Mr. Ping
• Optional: Flatpak Steam or native steam

git clone https://github.com/sunnyscoop300-a11y/hpo.git
cd hpo
hare build -o hpo src/
sudo install -m755 hpo /usr/local/bin/hpo
sudo install -m755 helpers/shifu-events.py /usr/local/share/hpo/

Or use the beginner-friendly bootstrap (builds the whole Hare toolchain first):

./install.sh

hpo --zhen-setup --proton

hpo croc setup      # installs all 10 open-source games via Flatpak

mkdir -p ~/.config/hpo
echo "YOUR_OMDB_KEY" > ~/.config/hpo/omdb_key.txt   # free key from omdbapi.com/apikey.aspx

mkdir -p ~/.config/mpv/shaders
cd ~/.config/mpv/shaders
curl -LO https://github.com/bloc97/Anime4K/releases/download/v4.0.1/Anime4K_v4.0.zip
unzip -o Anime4K_v4.0.zip

YouTube's 2026 anti-bot system needs a JavaScript runtime. Install Deno and configure yt-dlp:

curl -fsSL https://deno.land/install.sh | sh
mkdir -p ~/.config/yt-dlp
cat > ~/.config/yt-dlp/config << 'EOF'
--js-runtimes deno:$HOME/.deno/bin/deno
--remote-components ejs:github
--cookies-from-browser brave
--extractor-args youtube:player_client=web_safari
EOF

mkdir -p ~/.local/share/hpo
curl -L -o ~/.local/share/hpo/bell.mp3 \
  "https://archive.org/download/LovelyMeditationBell/STE-015.mp3"

Same hpo binary, same commands — adapts to the environment automatically. On WSL, Chameleon reads Steam/Epic saves directly via /mnt/c.

This makes hpo shifu go from ~1.7s to ~4ms on the second call (~400x faster).

hpo draws on Kung Fu Panda, Kung Fu Panda: The Dragon Knight, Rooster Fighter, and The Wild Robot:

• 🐯 Po / Tigress — Steam alias & quote of the day
• 🐉 Zhen — the gaming engine (KFP4)
• 🦎 The Chameleon — save manager villain (KFP4)
• 🐆 Tai Lung — parallel download (KFP1)
• 🐵 Monkey — Rocket League (Furious Five)
• 🐍 Viper — PlayStation Remote Play (Furious Five)
• 🦗 Mantis — manga cart hub (Furious Five)
• 🐦 Crane — music player (Furious Five)
• 🐃 Kai — anime player with Anime4K (KFP3, the jade master)
• 🐊 Master Croc — retro arcade hub (Kung Fu Council)
• 🐒 Rukhmini — movie streaming server (Dragon Knight, the long-tailed macaque thief)
• 🪄 Akna — config memory wizard (Dragon Knight)
• 🐢 Oogway — meditation
• 🥋 Shifu — cinema oracle
• 🗡️ Bnet — Battle.net / WoW launcher
• 🦆 Mr. Ping — Roblox launcher
• 🐤 Piyoko — Piyokocoin wallet & retro arcade (Rooster Fighter)
• 🐓 Rooster / Keiji — encrypted Rooster links (Rooster Fighter)
• 🤖 Roz / Brightbill — weather robot (The Wild Robot)

hpo only helps with legal content: your own files, purchased games (Steam/Epic/GOG), your own disc/cartridge dumps, your own Blu-rays (personal backups via MakeMKV), your own Suno generations, free MAME ROMs, homebrew, open-source games, and freely-available streaming. It respects DRM and does not circumvent copy protection.

hpo is a hobby project by Bossun, built across:

• 🦊 FluxLinux (i7-6800K + GTX 1070)
• 🪟 WSL Ubuntu on Windows 11 (i7-13700K + RTX 4070)
• 🐯 EndeavourOS

Written in Hare because it's fun. Themed around Kung Fu Panda because Po is the Dragon Warrior. 🍍

Skadoosh!