Commanding HQ Player... The fun way

The HQPlayer control I showed earlier is now available: unified-hifi-control

  • Web UI — Control HQPlayer pipeline from a browser (filter, shaper, sample rate, mode, volume).
  • Home Assistant — MQTT sensors and controls for filter, shaper, sample rate, mode, and volume. Set MQTT_BROKER environment variable to enable.
  • Configuration (aka Profile) switching if using Embedded with web credentials. I recommend matching profile names to profile title to get the current configuration to show up correctly.
  • AI assistants — MCP server for text-based control via Model Context Protocol clients.

Works with HQPlayer Desktop or Embedded:

  • Pipeline control: Both Desktop and Embedded
  • Configuration switching: Embedded only (requires web credentials)

Setup via Docker. Configure HQP_HOST, HQP_PORT (default 8088), and optionally HQP_USER/HQP_PASS for profile loading if you use Embedded Docker Compose in the repo README.

I hope to add profile selection to the Knob firmware in the next week.

2 Likes