Prerequisites
‣ Processor with support for SSE4.2 instructions on x86-64, or 64-bit ARM
‣ BIOS capable of UEFI boot (bootable image)
‣ Audio device(s) with ALSA driver support
‣ Ubuntu Server 24.04 LTS Noble Numbat, Debian 12 Bookworm or Fedora 39 Server/Minimal 64-bit OS installed
‣ No graphical user interface / desktop environment
Downloading and installing packages
Install necessary packages, dependencies for these packages are available in the OS package repository.
Download and install libgmpris (and libsoup3 for Debian Bookworm) packages. And then the hqplayerd package for your distribution.
Package contains example configuration file and documentation as a readme text file.
Downloading and configuring bootable image
Download the hqplayer-embedded image and write the image to a media you plan to use for booting, such as USB memory stick.
Once booted up, you can use the web management interface from another computer using URL “http://hqplayer.local:8088” or login as “root” (no password) from console. Default username for web interface is “hqplayer” and default password is “password“. Please change the password as soon as possible, either through the web interface, or from command line using command “hqplayerd -s username password“. The image will attempt to appear under name “hqplayer” on the network, but you can also see the obtained IP adress using command “ifconfig”, “ip a”, or from HQPlayer Client’s control panel.
Additional documentation can be found in /usr/share/hqplayer/readme.txt
Currently available overlays on RaspberryPi images
‣ allo-boss-dac-pcm512x-audio
‣ allo-digione
‣ allo-katana-dac-audio
‣ allo-piano-dac-pcm512x-audio
‣ allo-piano-dac-plus-pcm512x-audio
‣ applepi-dac
‣ audioinjector-addons
‣ audioinjector-ultra
‣ audioinjector-wm8731-audio
‣ audiosense-pi
‣ audremap
‣ dionaudio-loco
‣ dionaudio-loco-v2
‣ disable-bt
‣ disable-wifi
‣ dwc-otg
‣ dwc2
‣ fe-pi-audio
‣ gpio-fan
‣ gpio-poweroff
‣ gpio-shutdown
‣ hifiberry-amp
‣ hifiberry-dac
‣ hifiberry-dacplusadc
‣ hifiberry-dacplusadcpro
‣ hifiberry-dacplusdsp
‣ hifiberry-dacplushd
‣ hifiberry-dacplus
‣ hifiberry-digi
‣ hifiberry-digi-pro
‣ iqaudio-codec
‣ iqaudio-dac
‣ iqaudio-dacplus
‣ iqaudio-digi-wm8804-audio
‣ i-sabre-q2m
‣ justboom-both
‣ justboom-dac
‣ justboom-digi
‣ media-center
‣ merus-amp
‣ rpi-cirrus-wm5102
‣ rpi-dac
‣ rpi-poe
‣ superaudioboard