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

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

┌─────────────────────────────────────────────────────────────────────┐
│                   Unified Hi-Fi Control Bridge                       │
│  ┌────────┐  ┌────────┐  ┌──────────┐  ┌────────┐  ┌──────────┐    │
│  │  Roon  │  │ Lyrion │  │ OpenHome │  │  UPnP  │  │ HQPlayer │    │
│  │        │  │  /LMS  │  │          │  │  /DLNA │  │   DSP    │    │
│  └────────┘  └────────┘  └──────────┘  └────────┘  └──────────┘    │
│                                                                      │
│  HTTP API + SSE                                                       │
└─────────────────────────────────────────────────────────────────────┘
                              │
              ┌───────────────┴───────────────┐
              ▼                               ▼
           ESP32                           Web UI
           Knob

MCP Server (Claude Integration)

Control your hi-fi with natural language. The bridge includes an MCP server so Claude can search, play, queue music, adjust volume, and switch HQPlayer profiles.

Setup

1. Start the bridge (docker compose up -d)
2. Add to your MCP config (Claude Code, ChatGPT, BoltAI, etc.):

{
  "mcpServers": {
    "unified-hifi-control": {
      "type": "http",
      "url": "http://<your-bridge-host>:8088/mcp"
    }
  }
}

Available Tools

Search and play work with Roon and LMS. Transport controls work with all adapters.

Example Usage

Ask Claude: "Play some jazz piano" or "Queue Hotel California" or "What's playing?" or "Turn the volume down"

rustup target add wasm32-unknown-unknown
cargo install dioxus-cli --locked
cp scripts/pre-commit .git/hooks/

make css                                              # Build Tailwind CSS
dx build --release --platform web --features web      # Build server + WASM

cd target/dx/unified-hifi-control/release/web
PORT=8088 ./unified-hifi-control                      # Run at http://localhost:8088

PORT=8088 dx serve --release --platform web --features web --port 8088

cargo test --workspace
cargo fmt --check && cargo clippy -- -D warnings

License

As of v2.5.0, this project is licensed under the PolyForm Noncommercial 1.0.0 license.

Versions up to and including v2.4.1-prior-license were released under a custom source-available license (see LICENSE-PRIOR).

For commercial licensing inquiries, see COMMERCIAL-LICENSE.md.