HQPlayer Embedded Discussion

I’ve upgraded to 6.0.1.2 embedded on Ubuntu and hqplayerd is running and I have reset the credentials and restarted hqplayerd. But I cannot connect in the browser → ERR_CONNECTION_REFUSED. This is on Firefox in Windows and Brave on Android.

I am getting this when checking the status of hqplayerd :slight_smile:

May 27 08:28:48 hqplayerserver systemd[1]: hqplayerd.service: Scheduled restart job, restart counter is at 58.
May 27 08:28:48 hqplayerserver systemd[1]: Started hqplayerd.service - HQPlayer Embedded daemon.
May 27 08:28:48 hqplayerserver hqplayerd[6146]: active locale: C.UTF-8
May 27 08:28:48 hqplayerserver hqplayerd[6146]: CUDA devices: 1
May 27 08:28:48 hqplayerserver hqplayerd[6146]: Signalyst HQPlayer Embedded v6.0.1
May 27 08:28:48 hqplayerserver hqplayerd[6146]: Copyright (C) 1998-2026 Jussi Laako / Signalyst. All rights reserved.
May 27 08:28:48 hqplayerserver hqplayerd[6146]: CUDA device 0: NVIDIA GeForce RTX 5080
May 27 08:28:48 hqplayerserver hqplayerd[6146]: [0.112] message: app path: /var/lib/hqplayer/
hal9001@hqplayerserver:~$ sudo service hqplayerd status
● hqplayerd.service - HQPlayer Embedded daemon
Loaded: loaded (/usr/lib/systemd/system/hqplayerd.service; enabled; preset: enabled)
Active: activating (auto-restart) (Result: exit-code) since Wed 2026-05-27 08:28:51 UTC; 1s ago
Process: 6146 ExecStart=/usr/bin/hqplayerd (code=exited, status=255/EXCEPTION)
Main PID: 6146 (code=exited, status=255/EXCEPTION)
CPU: 569ms

Looks like there is an exception and hqplayerd stops:

sudo service hqplayerd status
● hqplayerd.service - HQPlayer Embedded daemon
Loaded: loaded (/usr/lib/systemd/system/hqplayerd.service; enabled; preset: enabled)
Active: activating (auto-restart) (Result: exit-code) since Wed 2026-05-27 08:31:12 UTC; 1s ago
Process: 7246 ExecStart=/usr/bin/hqplayerd (code=exited, status=255/EXCEPTION)
Main PID: 7246 (code=exited, status=255/EXCEPTION)
CPU: 531ms

I also had issues with missing dependencies but fixed that and the version 6 deployment went through.

What have I missed?

I followed these instructions :

On Linux, first define a username and password for the web interface with “sudo hqplayerd -s username password”. Then the service can be enabled with “sudo systemctl enable hqplayerd” and started immediately with “sudo systemctl start hqplayerd”.

hqplayerd is continually crashing and restarting as I can see the restart counter continually updating.

Note that I took the 6.0.1 Ubuntu packages off and I’m rebuilding the 6.0.1 package today. But the reason is not any known problem or such. Just want to include couple of other things on the 6.0.1 as well.

You could check “journalctl -u hqplayerd” to check if it shows the exception reason. If not, stop the service with “systemctl stop hqplayerd” and then just start “hqplayerd” as root and see if it will tell about the exception (it should).

Since you have Nvidia GPU, check that you have Nvidia driver version >= 610.43.02.

Some sort of network issue:

May 27 15:32:02 hqplayerserver systemd[1]: hqplayerd.service: Scheduled restart job, restart counter is at 69.
May 27 15:32:00 hqplayerserver systemd[1]: hqplayerd.service: Failed with result ‘exit-code’.
May 27 15:32:00 hqplayerserver systemd[1]: hqplayerd.service: Main process exited, code=exited, status=255/EXCEPTION
May 27 15:32:00 hqplayerserver hqplayerd[4011]: [2.483] error: clUPnPControl::Start(): clUPnPRenderer::Start(): clUPnP::Start(): no network interfaces available
May 27 15:32:00 hqplayerserver hqplayerd[4011]: [2.483] message: enable UPnP Renderer functionality for interface: br0
May 27 15:31:57 hqplayerserver hqplayerd[4011]: [0.113] message: app path: /var/lib/hqplayer/
May 27 15:31:57 hqplayerserver hqplayerd[4011]: CUDA device 0: NVIDIA GeForce RTX 5080
May 27 15:31:57 hqplayerserver hqplayerd[4011]: Copyright (C) 1998-2026 Jussi Laako / Signalyst. All rights reserved.
May 27 15:31:57 hqplayerserver hqplayerd[4011]: Signalyst HQPlayer Embedded v6.0.1

Running as root:

hal9001@hqplayerserver:~$ sudo hqplayerd
active locale: C.UTF-8
CUDA devices: 1
Signalyst HQPlayer Embedded v6.0.1
Copyright (C) 1998-2026 Jussi Laako / Signalyst. All rights reserved.
CUDA device 0: NVIDIA GeForce RTX 5080
[0.144] message: app path: /var/lib/hqplayer/
[2.129] message: enable UPnP Renderer functionality for interface: br0
[2.129] error: clUPnPControl::Start(): clUPnPRenderer::Start(): clUPnP::Start(): no network interfaces available

Is there some further config needed for Upnp?

I thought it may have been something to do with the NAA not running but I still get this error when the NAA is present on the network.

UPnP is set to use “br0” as network interface, but such is not available…

I would suggest to set it to “auto”.

That’s worked.

HQPlayer is now running but I am now getting this trial licence issue despite resetting my credentials and restarting the service (as previously described). Rebooting has no effect. Perhaps there is some re-configuration required in hqplayerd.xml?

I can upload my licence file but the licence is still showing as a trial. Is a re-purchase necessary for v6? Yes. Looks like I have a coupon code now for V6 but when I try to use it it’s asking me for payment. Is this not a free upgrade? I can’t see a green buy button in Firefox only the “Buy HQPlayer Embedded” button. And the coupon code gives a small discount.

To use a coupon code, please use the green buy-button to proceed. The code is valid only on through the 2checkout store.

Thought this was a free upgrade. Evidently not. I need to see whether UPnP is worth the extra £280 as I assume I can use any UPnP renderer with HQPlayer.

Depending on age of HQPlayer version 5 license, there’s varying amount of upgrade discount. But yes that’s the button.

I’m not sure I completely understand this. HQPlayer is a UPnP Renderer, it doesn’t use one.

Of course there are other new features as well, and will be many more in coming years.

Is it possible to rollback to V5 and go to V6 at a later date? If so what is the easiest way of doing this using my current v5 licence file?

Of course, you can just install any hqplayerd package over the earlier one.

1 Like

I’m late for the new version, but I intend to purchase one on June 2! :wink:

I ran into the error message thing for the discount, so I am waiting for a reply from Aapo.

HQPlayer 6.x SDK support in Jellyfin2HQPlayer is now basically in place.

The new Source Cleanup / Pre-filter controls are working, and support for the new Filters Description field from HQPlayer 6.x has also been integrated into the HQPlayer Settings UI.

In the screenshot:
J2H is controlling HQPlayer 6.0.1 while displaying the new Pre-filter options together with the live Spectrogram + Levelbar view.

J2H will continue to maintain compatibility with both HQPlayer 5.x and 6.x.

GitHub:
https://github.com/YTSamLee/jellyfin2hqplayer

2 Likes

I have rolled back to 5.17.2.

Do I need a new license file?

I am getting a failure when trying to upload the license file:

Web license key write failed, no path

Looks like some config is missing.

As an aside I will eventually upgrade to v6 but it looks like currently there is more value for Windows/MAC users and I am more than happy with v5.

As an aside I will eventually upgrade to v6 but it looks like currently there is more value for Windows/MAC users and I am more than happy with v5.

In other words, why is there “more advantage” to V5 than V6?

Personally, I switched to V6 on my M4 Mac mini with macOS.

Your existing key file is fine. If you are running hqplayerd as a service, check that /etc/hqplayer directory is owned by “hqplayer” user. Otherwise it won’t be able to write files there.

@jussi_laako
So, Fedora is now 44?
Such a short life for 43…

Yes, Nvidia moved to 44 on CUDA 13.3. I don’t really miss 43…

1 Like

Never mind, is working now reads the library

Working ok with authentication disabled

1 Like

It looks to me that user hqplayer has the correct permissions:

hal9001@hqplayerserver:/etc$ stat hqplayer
File: hqplayer
Size: 4096 Blocks: 8 IO Block: 4096 directory
Device: 252,0 Inode: 6291684 Links: 2
Access: (0755/drwxr-xr-x) Uid: ( 114/hqplayer) Gid: ( 0/ root)
Access: 2026-05-29 05:29:44.733847579 +0000
Modify: 2026-05-28 16:08:44.974331736 +0000
Change: 2026-05-29 05:29:33.520778850 +0000
Birth: 2026-05-28 16:07:44.333086224 +0000

but I still get

  2026/05/29 05:54:31 Web license key write failed, no path

Do I need to reset username/password:

You have hqplayerd running as a service (the default)? And you have set the default credentials from command line before starting the service? (as documented in the installation instructions)

You can also place the key file manually there, as instructed in the readme.txt. So you can just copy the key file to /etc/hqplayer/hqplayerd6-key.xml and please check that it has hqplayer:root 0600 permissions. Then restart the hqplayerd service.

Thank you. Looks like I am now back up and running. I had to upload the most recent licence file that you sent me although when I compared the license files I had they all appeared to be identical but only the most recent one worked. So I assume they weren’t identical.

Anyway it looks like I am good to go now. NAA and DAC have been recognised.

I will keep an eye on developments with V6 and upgrade as and when the time is right.

3 Likes

@jussi_laako
Hi.
I’m having trouble accessing the web control for HQPlayer embedded 6 on Fedora 44.

I removed the web credentials and rebooted Google Chrome on the remote PC, but it still doesn’t work…

What is likely that I did wrong?