A TUI for browsing and streaming music via the HiFi API (a Tidal proxy). Runs on Linux and Windows.

• Search tracks, albums, and artists
• Stream lossless and hi-res audio via mpv
• Queue management with reordering and shuffle/repeat modes
• Recommendations based on currently playing track
• Playlists — create, rename, delete, and reorder tracks within playlists
• Downloads — lossless FLAC with full metadata, cover art, synced lyrics, and CUE files
• Track metadata modal showing quality, BPM, key, ISRC, and more
• Last.fm scrobbling with now-playing and scrobble support
• Command palette (Ctrl+P) listing all keybindings

• Python 3.10+
• mpv
• ffmpeg (required for HiRes DASH downloads)

python -m venv venv
venv/bin/pip install textual requests mutagen

python -m venv venv
venv\Scripts\pip install textual requests mutagen

mpv must be installed and available on your PATH:

winget install mpv
winget install Gyan.FFmpeg

The API base URL is set in src/hifi_tui/api.py. Change BASE_URL to point to your own HiFi API instance.

./run.sh

.\run.bat

Press Ctrl+P in the app to open the command palette with a searchable list of all keybindings.

Press d on any track or album to download it. Progress is shown in the Downloads tab.

Each download includes:

• Audio file — FLAC (lossless and HiRes streams)
• Cover art (cover.jpg)
• Synced lyrics (.lrc) when available, sourced from Tidal or lrclib.net
• Embedded metadata: title, artist, album, track number, disc number, date, ISRC, copyright, BPM, cover art
• CUE file (album downloads only)

The default download folder is ~/Music/hifi-tui/. You can change it in the Settings tab.

Open the Settings tab to configure Last.fm scrobbling. You'll need a free API key from last.fm/api/account/create.

Powered by hifi-api by binimum.

Thanks to monochrome for introducing me to the HiFi API.