v3.2.0 - MCP Server for AI Assistants

What's New

MCP Server for AI Assistant Integration - Control your hi-fi system with natural language through Claude, ChatGPT, or any MCP-compatible AI assistant.

Features

• Natural language control: "Play some jazz piano", "What's playing?", "Turn the volume down"
• Smart search: Search your library, TIDAL, or Qobuz (Roon zones)
• Queue building: Build playlists with multiple hifi_play calls using action='queue'
• HQPlayer control: Switch profiles and adjust DSP settings via AI

Setup

Add to your MCP config (Claude Code, ChatGPT, BoltAI, etc.):

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

After upgrading: Restart Claude Code to refresh MCP tool definitions.

Tools Available

Tool	Description
hifi_zones	List available zones
hifi_now_playing	Current track info
hifi_control	Play, pause, next, previous, volume
hifi_search	Search library/TIDAL/Qobuz (Roon only)
hifi_play	AI DJ: search and play/queue (Roon only)
hifi_status	Bridge status
hifi_hqplayer_*	HQPlayer DSP controls

---

⚠️ Roon Users: Re-authorization Required

This release adds new Roon API capabilities (Browse API for search/play). You'll need to re-authorize the extension in Roon → Settings → Extensions.

The bridge will reconnect automatically after you approve.

---

Installation Notes

Synology

⚠️ Known issues with the SPK package. Docker installation recommended.

Linux Packages (rpm, deb, Arch)

⚠️ These packages are untested. Please report issues.

---

Bug Fixes

• Fixed volume control via hardware knob after zone_id refactor
• Fixed HQPlayer settings rejecting valid negative mode values
• Improved MCP tool descriptions for better AI model understanding

Full Changelog

v3.1.9...v3.2.0

Download Guide

Standalone Binaries

All binaries include embedded web assets - no separate download needed.

Platform	File
Linux x64	unified-hifi-linux-x64
Linux ARM64	unified-hifi-linux-arm64
Linux ARMv7	unified-hifi-linux-armv7
macOS (Universal)	unified-hifi-macos-universal
Windows x64	unified-hifi-win64.exe

Linux Packages

• .deb packages for Debian/Ubuntu
• .rpm packages for Fedora/RHEL

NAS Packages

• .spk for Synology DSM 7+
• .qpkg for QNAP

LMS Plugin

• lms-unified-hifi-control-*.zip - Install via LMS Settings > Plugins

v3.1.9

What's Changed

Fixes

• Mobile layout - Zones page now shows single column on phones instead of cramped two-column layout
• Knob power state diagram -(Normal → Dim → Sleep → Off interpretation) clarification
• Knob reconnection on restart - Knobs now detect when the bridge restarts and refresh their zone list (#180)
• Consolidated settings pages for cleaner navigation

Under the Hood

• Faster CI builds (reduced artifact size)
• Updated dependencies for security and stability

Full Changelog: v3.1.8...v3.1.9

Download Guide

Standalone Binaries

All binaries include embedded web assets - no separate download needed.

Platform	File
Linux x64	unified-hifi-linux-x64
Linux ARM64	unified-hifi-linux-arm64
Linux ARMv7	unified-hifi-linux-armv7
macOS (Universal)	unified-hifi-macos-universal
Windows x64	unified-hifi-win64.exe

Linux Packages

• .deb packages for Debian/Ubuntu
• .rpm packages for Fedora/RHEL

NAS Packages

• .spk for Synology DSM 7+
• .qpkg for QNAP

LMS Plugin

• lms-unified-hifi-control-*.zip - Install via LMS Settings > Plugins

Download Guide

Standalone Binaries

All binaries include embedded web assets - no separate download needed.

Platform	File
Linux x64	unified-hifi-linux-x64
Linux ARM64	unified-hifi-linux-arm64
Linux ARMv7	unified-hifi-linux-armv7
macOS (Universal)	unified-hifi-macos-universal
Windows x64	unified-hifi-win64.exe

Linux Packages

• .deb packages for Debian/Ubuntu
• .rpm packages for Fedora/RHEL

NAS Packages

• .spk for Synology DSM 7+
• .qpkg for QNAP

LMS Plugin

• lms-unified-hifi-control-*.zip - Install via LMS Settings > Plugins

v3.1.8

Fixes

• Roon volume control for dB devices: Fixed volume control not appearing for zones like Poly Mojo 2. When Roon reports a zone without volume data initially, then adds it later, the bridge now properly updates the zone with volume control.

Download Guide

Standalone Binaries

All binaries include embedded web assets - no separate download needed.

Platform	File
Linux x64	unified-hifi-linux-x64
Linux ARM64	unified-hifi-linux-arm64
Linux ARMv7	unified-hifi-linux-armv7
macOS (Universal)	unified-hifi-macos-universal
Windows x64	unified-hifi-win64.exe

Linux Packages

• .deb packages for Debian/Ubuntu
• .rpm packages for Fedora/RHEL

NAS Packages

• .spk for Synology DSM 7+
• .qpkg for QNAP

LMS Plugin

• lms-unified-hifi-control-*.zip - Install via LMS Settings > Plugins

v3.1.7

Fixes

• Roon volume safety (#168): Fixed a bug where volume could unexpectedly jump to maximum when Roon reported no volume data

• Roon extension info (#169, #170): The Roon Settings extension now shows the correct UHC version and number of connected hardware controllers (previously showed "0.0.0")

• Synology package compatibility (#171, #172): Fixed DSM 7 package installation issues:

  • Fixes based on feedback from a user who tested the previous package.
  • Download filenames now follow Synology conventions (e.g., unified-hifi-control-x86_64-3.1.7-dsm7.spk)

Download Guide

Standalone Binaries

All binaries include embedded web assets - no separate download needed.

Platform	File
Linux x64	unified-hifi-linux-x64
Linux ARM64	unified-hifi-linux-arm64
Linux ARMv7	unified-hifi-linux-armv7
macOS (Universal)	unified-hifi-macos-universal
Windows x64	unified-hifi-win64.exe

Linux Packages

• .deb packages for Debian/Ubuntu
• .rpm packages for Fedora/RHEL

NAS Packages

• .spk for Synology DSM 7+
• .qpkg for QNAP

LMS Plugin

• lms-unified-hifi-control-*.zip - Install via LMS Settings > Plugins

v3.1.6

LMS (Squeezebox) Improvements

More Reliable Updates

• Volume changes from iPhone, remote controls, and other apps now update correctly
• Track changes appear immediately instead of waiting for the next poll cycle
• Real-time updates recover faster after network interruptions

Better Debugging

• The /lms page now shows connection status and update mode (real-time vs polling)

Bug Fixes

• Fixed volume sometimes showing wrong values when using external controls
• Fixed track info becoming stale when changing songs quickly
• Fixed Roon, OpenHome, and UPnP volume controls not syncing in some cases

For Developers

• Added architecture tests to prevent common integration bugs
• Improved event consistency across all adapters

Full Changelog: v3.1.5...v3.1.6

Download Guide

Standalone Binaries

All binaries include embedded web assets - no separate download needed.

Platform	File
Linux x64	unified-hifi-linux-x64
Linux ARM64	unified-hifi-linux-arm64
Linux ARMv7	unified-hifi-linux-armv7
macOS (Universal)	unified-hifi-macos-universal
Windows x64	unified-hifi-win64.exe

Linux Packages

• .deb packages for Debian/Ubuntu
• .rpm packages for Fedora/RHEL

NAS Packages

• .spk for Synology DSM 7+
• .qpkg for QNAP

LMS Plugin

• lms-unified-hifi-control-*.zip - Install via LMS Settings > Plugins

v3.1.5

v3.1.5

Automatic Reconnection

The bridge now automatically reconnects to music servers when they restart or become temporarily unavailable. No more manual restarts needed.

What this fixes:

• Roon: Bridge reconnects when Roon Core restarts or when you reauthorize the extension (#150)
• LMS: Bridge waits patiently if LMS isn't running yet, then connects when it starts (#147)
• OpenHome/UPnP: Devices reappear automatically after network hiccups

Bug Fixes

• Fixed commands sometimes failing to reach the correct zone
• LMS and OpenHome now correctly report that mute isn't supported (instead of silently doing nothing)

Upgrade

Drop-in replacement. No configuration changes needed.

Download Guide

Standalone Binaries

All binaries include embedded web assets - no separate download needed.

Platform	File
Linux x64	unified-hifi-linux-x64
Linux ARM64	unified-hifi-linux-arm64
Linux ARMv7	unified-hifi-linux-armv7
macOS (Universal)	unified-hifi-macos-universal
Windows x64	unified-hifi-win64.exe

Linux Packages

• .deb packages for Debian/Ubuntu
• .rpm packages for Fedora/RHEL

NAS Packages

• .spk for Synology DSM 7+
• .qpkg for QNAP

LMS Plugin

• lms-unified-hifi-control-*.zip - Install via LMS Settings > Plugins

v3.1.4

Fixed

• Fine volume control restored — Volume now changes by the correct amount (0.5 dB where supported). This was a v3 regression caused by the Rust roon-api library truncating fractional values.
• Track info stays current — Song, artist, and album now update reliably when tracks change.
• Zones update automatically — Adding or removing a zone no longer requires a restart. This was a v3 regression.

Download Guide

Standalone Binaries

All binaries include embedded web assets - no separate download needed.

Platform	File
Linux x64	unified-hifi-linux-x64
Linux ARM64	unified-hifi-linux-arm64
Linux ARMv7	unified-hifi-linux-armv7
macOS (Universal)	unified-hifi-macos-universal
Windows x64	unified-hifi-win64.exe

Linux Packages

• .deb packages for Debian/Ubuntu
• .rpm packages for Fedora/RHEL

NAS Packages

• .spk for Synology DSM 7+
• .qpkg for QNAP

Download Guide

Standalone Binaries

All binaries include embedded web assets - no separate download needed.

Platform	File
Linux x64	unified-hifi-linux-x64
Linux ARM64	unified-hifi-linux-arm64
Linux ARMv7	unified-hifi-linux-armv7
macOS (Universal)	unified-hifi-macos-universal
Windows x64	unified-hifi-win64.exe

Linux Packages

• .deb packages for Debian/Ubuntu
• .rpm packages for Fedora/RHEL

NAS Packages

• .spk for Synology DSM 7+
• .qpkg for QNAP

LMS Plugin

• lms-unified-hifi-control-*.zip - Install via LMS Settings > Plugins

v3.1.3

LMS Plugin Fixes

• Fix settings page hang (synchronous handler)
• Fix repo.xml format for LMS parser compatibility
• Add details section to repo.xml
• Improve macOS Gatekeeper handling (xattr at init)
• Fix restart counter timer leak
• Reduce disk I/O for binary handling

Thanks to @mherger for the Helper.pm improvements!

Download Guide

Standalone Binaries

All binaries include embedded web assets - no separate download needed.

Platform	File
Linux x64	unified-hifi-linux-x64
Linux ARM64	unified-hifi-linux-arm64
Linux ARMv7	unified-hifi-linux-armv7
macOS (Universal)	unified-hifi-macos-universal
Windows x64	unified-hifi-win64.exe

Linux Packages

• .deb packages for Debian/Ubuntu
• .rpm packages for Fedora/RHEL

NAS Packages

• .spk for Synology DSM 7+
• .qpkg for QNAP

LMS Plugin

• lms-unified-hifi-control-*.zip - Install via LMS Settings > Plugins

v3.1.2

Highlights

Roon Disconnect Stability (Issue #128) - Fixed high CPU usage and connection handling issues when Roon Core disconnects or becomes unavailable. The bridge now gracefully handles disconnects without spinning.

Single-Binary Distribution - Web assets (CSS, JS, images) are now embedded directly in the binary. No more separate public/ folder needed - just download and run.

Bug Fixes

• fix(roon): Prevent high CPU when Roon Core disconnects
• fix(roon): Clear image service and pending requests on disconnect
• fix(roon): Route image responses to correct pending request by image_key
• fix(ui): Use per-zone SSE updates to prevent album art race conditions
• fix: Release locks before awaiting to prevent potential contention
• fix: Version display no longer flickers between SSR and client

Improvements

• feat: Single-binary asset distribution - all web assets embedded (ADR 002)
• ci: Build WASM once and share across all platform builds (~5 min savings)
• ci: Content-based WASM caching with incremental rebuild support

Internal

• Added AST-based lints to catch async Rust bugs (await-in-lock, ignored sends)
• Improved lock handling patterns across adapters

---

Full Changelog: v3.1.1...v3.1.2

Download Guide

Standalone Binaries

Platform	File
Linux x64	unified-hifi-linux-x64
Linux ARM64	unified-hifi-linux-arm64
Linux ARMv7	unified-hifi-linux-armv7
macOS (Universal)	unified-hifi-macos-universal
Windows x64	unified-hifi-win64.exe

Linux Packages

• .deb packages for Debian/Ubuntu
• .rpm packages for Fedora/RHEL

NAS Packages

• .spk for Synology DSM 7+
• .qpkg for QNAP

LMS Plugin

• lms-unified-hifi-control-*.zip - Install via LMS Settings > Plugins

Web Assets

• web-assets.tar.gz - Pre-built web UI (included in packages)

v3.1.1

Changes

• LMS Plugin: Universal ZIP bundles all platform binaries (~120MB)
  • No more download-on-demand - simpler, more reliable
  • Uses LMS's built-in findBin() with platform folder structure
• CI: Fixed rust-cache for v3 branch, Docker x64 skip on releases, AUR publishing

Download

Install via LMS Extension Downloader or download the universal ZIP from assets below.

Download Guide

Standalone Binaries

Platform	File
Linux x64	unified-hifi-linux-x64
Linux ARM64	unified-hifi-linux-arm64
Linux ARMv7	unified-hifi-linux-armv7
macOS (Universal)	unified-hifi-macos-universal
Windows x64	unified-hifi-win64.exe

Linux Packages

• .deb packages for Debian/Ubuntu
• .rpm packages for Fedora/RHEL

NAS Packages

• .spk for Synology DSM 7+
• .qpkg for QNAP

LMS Plugin

• lms-unified-hifi-control-*.zip - Install via LMS Settings > Plugins

Web Assets

• web-assets.tar.gz - Pre-built web UI (included in packages)