hifi-control

Unified Hi-Fi Control

Control your hi-fi system from anywhere — a hardware knob on your couch, your phone, or just ask Claude.

This bridge connects your music sources (Roon, LMS, UPnP) to any control surface you prefer. No vendor lock-in: mix and match sources, add HQPlayer DSP processing, and control it all from one place.

Control Surfaces

Once the bridge is running, control your system from:

• Web UI — Built-in at http://your-bridge:8088
• roon-knob — ESP32-S3 hardware knob with OLED display
• iOS & Apple Watch — In alpha testing. Get in touch if you'd like to try it.
• Claude & AI agents — Via the built-in MCP server (see MCP Server below)

Installation

Docker (Recommended)

docker pull muness/unified-hifi-control:latest

Synology NAS (DSM 7)

Download the SPK package from Releases:

• unified-hifi-control_*_apollolake.spk — Intel x86_64 (DS918+, DS920+, etc.)
• unified-hifi-control_*_rtd1296.spk — ARM64 (DS220+, DS420+, etc.)

QNAP NAS

Download the QPKG package from Releases:

• unified-hifi-control_*_x86_64.qpkg — Intel/AMD x86_64
• unified-hifi-control_*_arm_64.qpkg — ARM64

LMS Plugin

Add this repository URL in LMS Settings → Plugins → Additional Repositories:

https://raw.githubusercontent.com/open-horizon-labs/unified-hifi-control/v3/lms-plugin/repo.xml

Then install "Unified Hi-Fi Control" from the plugin list. The plugin automatically downloads and manages the bridge binary.

Binary Downloads

Pre-built binaries available for Linux (x64, arm64, armv7), macOS (x64, arm64), and Windows from Releases.

Quick Start (Docker)

# docker-compose.yml
services:
  unified-hifi-control:
    image: muness/unified-hifi-control:latest
    network_mode: host  # Required for Roon/UPnP discovery
    volumes:
      - ./data:/data
    environment:
      - CONFIG_DIR=/data
      # - UHC_PORT=8088       # Bridge port (default: 8088)
      # - RUST_LOG=info       # Log level: trace, debug, info, warn, error
    restart: unless-stopped

docker compose up -d
# Access http://localhost:8088

Environment Variables

Variable	Description	Default
UHC_PORT	Bridge HTTP port	8088
CONFIG_DIR	Directory for config/state files	/data
RUST_LOG	Log filter (e.g., info, debug, unified_hifi_control=debug)	debug
LMS_HOST	Auto-configure LMS backend (used by LMS plugin)	—
LMS_PORT	LMS server port	9000

Legacy aliases: PORT (→ UHC_PORT), LOG_LEVEL (→ RUST_LOG)

Note: Port 8088 is also HQPlayer's default. If running both on the same host, change one.

HQPlayer DSP Integration

If you route audio through HQPlayer for upsampling or filtering, this bridge lets you control HQPlayer's DSP settings (profiles, filters, shapers) alongside your zone controls.

Note: You need to set up audio routing to HQPlayer separately (via Roon, LMS/BubbleUPnP, or OpenHome). This bridge exposes the DSP controls, not the audio path.

Setup

1. Open the web UI at /hqplayer
2. Enter your HQPlayer host IP and ports (native: 4321, web: 8088)
3. Link zones to HQPlayer instances — each zone can use a different HQPlayer
4. Zone now-playing info will include HQPlayer pipeline status

Architecture