khi-explorer

A highly polished, dead-simple TUI browser, player and bulk downloader for KHInsider that just works.

YES, you can download entire albums with this!

Features

• Interactive TUI — Search for OST, filter tracks and navigate with keyboard-only controls
• Audio Playback — Stream playback right from your terminal
• Bulk Downloads — Download individual tracks or entire albums by pressing D on the entry
• Search & Filter — Find games and tracks quickly with fuzzy search
• Quick Format Switch — Toggle FLAC/MP3 inside the app by pressing TAB
• Configurable — Set your preferred format and download path in ~/.khi_explorer.yaml
• Cross-platform — Use on Linux, macOS and Windows

Usage

khi-explorer

TUI Navigation

Key	Action
↑ / ↓ or k / j	Move selection cursor up/down
← / →	Previous/Next page
Enter	Select album, search, or play song
Esc / Backspace	Go back to previous view
/	Enter filter/search mode
Tab	Toggle download format (FLAC ⇆ MP3)
q / Ctrl+C	Quit

Playback Controls

Key	Action
P	Pause or resume playback
S	Stop playback

Download Controls

Key	Action
D	Queue highlighted song for download (Album view)
D	Queue entire album for download (Search results view)

Configuration

Configuration is stored at ~/.khi_explorer.yaml:

format: flac                         # Download format (flac, mp3)
download_path: ~/khi_explorer        # Download destination
player: mpv                          # Audio player command

Installation

Unix (Linux / macOS)

curl -fsSL https://artifacts.grolmes.com/khi-explorer/install.sh | sh

Windows

irm https://artifacts.grolmes.com/khi-explorer/install.ps1 | iex

Build from Source

git clone https://github.com/madLinux7/khi-explorer.git
cd khi-explorer
go build -o khi-explorer .

✨ Acknowledgements ✨

• KHInsider — For hosting such an extensive collection of video game music
• charmbracelet/bubbletea — For the elegant TUI framework
• charmbracelet/lipgloss — For beautiful styling primitives