Powered by Qobuz. Requires a paid subscription. This does not allow you to listen for free.
Qobuz only supports Linux through the browser and has no officially supported API. There are ways of accessing Qobuz in Linux outside of the browser through third-party applications like Squeezelite and Roon. These apps are great, but I wanted something simpler that just focused on being able to quickly find and play an album inside the console.
- Low resource usage
- GStreamer-backed player, SQLite database
- High resolution audio: Supports up to 24bit/192Khz (max quality Qobuz offers)
- MPRIS support (control via playerctl or other D-Bus client)
- Gapless playback
- Resume last session
- Optional Web UI with WebSocket API
In addition to the player, there is a Spotify to Qobuz playlist sync tool and an incomplete Rust library for the Qobuz API.
- GStreamer v1.20+ (comes with most/all current Linux and MacOS versions)
Download the tar.gz file for your OS from the releases page, extract the file and execute hifi-rs or copy it to the your $PATH.
To make building from source easier, there is a Dockerfile to compile the project for Linux into a container.
Run build_linux.sh to automatically build the app in Docker and output the file.
Run hifi-rs --help or hifi-rs <subcommand> --help to see all available options.
To get started:
hifi-rs config username # enter username at prompt
hifi-rs config password # enter password at prompt
hifi-rs config default-quality # enter quality at prompt (mp3, cd, hifi96 or hifi192)
# play from the command line
hifi-rs play --url <Qobuz Album, Playlist or Track URL>
# open player
hifi-rs open
# open player with web ui
hifi-rs --web openThe TUI has full mouse support.
| Command | Key(s) |
|---|---|
| Now Playing | 1 |
| My Playlists | 2 |
| Search | 3 |
| Enter URL | 3 |
| Cycle elements | tab |
| Play/Pause | space |
| Next track | N |
| Previous track | P |
| Jump forward | l |
| Jump backward | h |
| Quit | ctrl + c |
| Move up in list | up arrow |
| Move down in list | down arrow |
| Select item in list | enter |
| Dismiss popup | esc |
The player can start an embedded web interface along with a websocket API. As this is a potential attack vector, the
server is disabled by default and must be started with the --web argument. It also listens on 0.0.0.0:9888 by default,
but an inteface can be specified with the --interface argument.
Go to http://<ip>:9888 to view the UI. The WebSocket API can be found at ws://<ip>:9888/ws.
There is no security on the WebSocket API, however it will reject any messages that cannot be parsed into a player action and it only interacts with the player. There is no reading or writing to the file system by the serve. All files are served from within the binary.
For any new clients, the server will send a stream of messages that bootstrap the active state of the player.
To control the player through the WebSocket API, send it a message with the required action.
Example payloads:
Play:
{ "play": null }Pause:
{ "pause": null }Skip To Track:
{ "skipTo": { "num": "<track index>"} }For more options, see the Action enum.
- UI will freeze during loading of long lists and then works fine. The issue is there is no feedback alerting the user that something is happening in the background and signifying it is normal behavior. Probably best solved when switching to Cursive.
- Sortable lists