Skip to content

SofusA/qobuz-player

Repository files navigation

qobuz-player

High resolution audio player backed by Qobuz

Powered by Qobuz. Requires a paid subscription. This does not allow you to listen for free.

The player includes a terminal ui, a web-ui and a RFID player. The web interface is ideal for a setup with a single board computer, e.g. Raspberry Pi, connected to the speaker system and controlled with a smartphone or tablet.

Terminal UI

TUI Screenshot

Keyboard Shortcuts

Press ? for an overview of all available keyboard shortcuts

Web UI

RFID player

RFID player

Read more in the wiki

Player Features

  • High resolution audio: Supports up to 24bit/192Khz (max quality Qobuz offers)
  • MPRIS support (control via playerctl or other D-Bus client)
  • Gap-less playback
  • Web UI
  • Terminal UI

Installation

Download Release

Download the tar.gz file for your supported OS from the releases page, extract the file and execute qobuz-player or copy it to your $PATH.

Installation with cargo

cargo install --git https://github.com/SofusA/qobuz-player

Build from source

Linux dependencies: alsa-sys-devel, just.

cargo build

Development

  1. Setup sqlx: just create-env-file. Only needed once.
  2. Init sqlite database: init-database.
  3. For webui development in qobuz-player-web:
  • npm i. Install npm dependencies.
  • npm run watch. Watch for style changes.

Get started

Run qobuz-player --help or qobuz-player <subcommand> --help to see all available options.

To get started:

qobuz-player config username {USERNAME}
qobuz-player config password {PASSWORD}
# or to get prompted for the password
qobuz-player config password

# open tui player
qobuz-player

# open player with web ui
qobuz-player open --web 

Web UI

The player can start an embedded web interface. This is disabled by default and must be started with the --web argument. It also listens on 0.0.0.0:9888 by default. Change port with --port argument.

Go to http://localhost:9888 to view the UI.

Contribution

Feature requests, issues and contributions are very welcome.

Credits

Qobuz-player started as a fork of hifi.rs but has since diverged.