Configuring HQPlayer Embedded as Renderer

Note! HQPlayer Embedded 4 Alpha-release is totally unsupported extra, provided as-is, for existing HQPlayer Embedded license owners!


Requesting license key

Send an email to support [a] signalyst [.] com from your registered email address requesting license key for HQPlayer Embedded. In the request, include hardware fingerprint found from About-dialog of the HQPlayer Desktop.

Copy the obtained key file to $HOME/.hqplayer/hqplayerd4-key.xml

Downloading and installing necessary packages

Install necessary dependencies
apt-get install libglib2.0-0 libflac8 libasound2 libgomp1
apt-get install rygel

Also download and install libgmpris package. And then the hqplayerd package.

Configuring HQPlayer and Rygel

HQPlayer Embedded will utilize most of the configuration settings done by HQPlayer Desktop. There are some additional options specified in /usr/share/doc/hqplayerd/readme.txt.gz such as option to switch to SDM output mode and to configure name for the renderer. These need to be manually changed to the configuration file.

To configure Rygel, copy example configuration file
zcat /usr/share/doc/hqplayerd/rygel.conf.gz >$HOME/.config/rygel.conf

Hint! By modifying rygel.conf you can enable it's media server functionality, including transcoding to play back formats otherwise unsupported by HQPlayer.

Starting the renderer

First start HQPlayer
and then start Rygel
now the system should appear in Control Point as a Renderer.

Note! Do not try to run both Desktop and Embedded version simultaneously, accessing audio device will fail.

Running the renderer as headless background task

These instructions cover setup for Debian Stretch. Since Stretch comes with the necessary DSD support, on minimal install:

  1. Install acpid, libasound2, libpam-systemd, libflac8, libglib2.0 libgomp1 and rygel (optional: linux-image-rt-amd64)
  2. Install libgmpris and tlm from here
  3. Install hqplayerd from here and check configuration and install key file in /etc/hqplayer/
  4. Extract configuration tarball to root directory of your device
  5. Add user music "useradd -m -g users -G audio music"
  6. Set password for the user music "passwd music"
  7. Login as user music and check that components get started properly using command "/etc/session.d/user-session"
  8. Enable tlm with "systemctl enable tlm" and start tlm with command "systemctl start tlm"
  9. Renderer will now start automatically on boot and you can nicely shutdown the system using short press on power button