Terminal Trove catalogs command-line and terminal user-interface tools for discovery.
tuifi
tuifi provides music playback for the TIDAL HiFi API through a terminal interface.
tuifigit.sr.ht/~matf/tuifiVisit siteAbout tuifi
tuifi is a terminal-based music player that connects to a self-hosted TIDAL HiFi API instance. It can browse and search artists and albums, stream tracks, manage queues and playlists, and cache tracks locally for offline playback in other players.
It is intended for TIDAL subscribers who self-host their own HiFi instance and prefer keyboard-driven terminal control. It requires Python, mpv and ffmpeg plus an API URL, and TIDAL has been blocking HiFi API accounts, with higher risk when an instance is shared.
Key features
- Stream TIDAL tracks through a self-hosted HiFi API instance
- Control playback with play, pause, seek, volume, repeat and shuffle
- Extend queue automatically with mixes or recommendations
- Create playlists and like tracks, albums, artists and mixes
- Cache tracks locally for offline playback in other players
- Show lyrics, cover art and audio spectrum in compatible terminals
Best for: TIDAL subscribers who self-host a HiFi API instance and prefer a keyboard-driven terminal workflow.
Good for
- Runs from a cloned repository with a wrapper script and no system installation
- Keeps playlists, history, liked songs and queue in local JSON files
- Supports keyboard and mouse input with customizable colors and metadata fields
Watch out for
- Requires a TIDAL subscription and a self-hosted HiFi API instance with its URL
- Requires Python, mpv and ffmpeg, with Python 3.13 specified on Windows
- TIDAL has blocked HiFi API accounts, with higher risk when an instance is shared
tuifi at a glance
- Website
- git.sr.ht/~matf/tuifi
- Category
- Software & Utilities › Linux & Mac Apps
- Type
- Website
- Pricing
- Not confirmed. Check the site
- Platforms
- Web, Windows
- Open source
- Not stated
- Language
- English
- Last checked
- Oct 5, 2026 · Online when checked
- Listed
- Oct 5, 2026
tuifi alternatives
Tools and sites you could use instead, ranked by how closely they match.
Magit puts Git operations in a text-based interface inside Emacs, according to its project page.
fm manages files in a terminal interface, with its project built using Go and Bubble Tea.
Open source
24 alternatives
Photon reads RSS feeds in a terminal and supports sixel graphics, according to its project page.
mantra.py displays online manual pages from the terminal, according to its project description.
Prezto configures Zsh with defaults, aliases, functions, and command-line interface enhancements.
Open source
24 alternativesPopular in Linux & Mac Apps
Well-known listings from the same topic.
Browshbrow.shcalcursecalcurse.orgBibDeskbibdesk.sourceforge.ioCommandlineFUcommandlinefu.comBashlybashly.devzshzsh.org
tuifi FAQ
What do I need to run tuifi?
You need Python 3.7+ (3.13 on Windows), mpv, ffmpeg, and the base URL of your HiFi API instance, set with --api or in settings.jsonc.
Can I share one HiFi API instance with others?
Sharing is likely to raise red flags and get the associated account blocked, as TIDAL accounts and tokens are not meant to be shared under TIDAL's terms for individual accounts.
Can I keep tracks fetched for offline use permanently?
No. Fetching is intended for ephemeral listening while you are a subscriber, and tuifi defaults to the /tmp folder to discourage permanent copies.
Is something wrong or out of date?
Tell us and an editor will check it.
Own this website?
Claim this listing
Claim the listing and suggest updates yourself. An editor checks every claim first.