Home Theater Direct for Home Assistant (Marketplace integration)

Installs: 69 sharing analytics
GitHub stars: 2
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v0.0.40, October 3, 2026
Category: Media and entertainment, TV and streaming
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: htd
Source: github.com/theharshl/htd-home-assistant
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Home Theater Direct is an integration for HTD MC/MCA-66 and Lync whole house audio controllers. It talks to the controller locally, over a network connection or a serial USB link, and Home Assistant can discover it on the network. Each zone gets a media player with power, volume, mute and source selection, plus bass and treble sliders and a balance slider that is hidden by default. Lync units also get a Do Not Disturb switch per zone, which controls party mode and all-zones-on exclusion. Zone and source names are read from the controller and can be overridden, unused zones can be hidden, and the selectable sources can be limited per zone. A source ID attribute keeps a fixed source position so automations still match after a source is renamed, and an option can show the last known zone state while the amplifier is off.

Automatic summary of the README and code of theharshl/htd-home-assistant. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
Found by itself Home Assistant spots it on the network and offers to add it.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Media
Switches

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Connection Type

Connection Type

Home Theater Direct

Host name or IP Address
Port

Home Theater Direct

Serial device path

Device Setup

Device name

Zone Names

Zone 1
Zone 2
Zone 3
Zone 4
Zone 5
Zone 6
Zone 7
Zone 8
Zone 9
Zone 10
Zone 11
Zone 12

Also asked when at the zone filter step.

Source Names

Source 1
Source 2
Source 3
Source 4
Source 5
Source 6
Source 7
Source 8
Source 9
Source 10
Source 11
Source 12
Source 13
Source 14
Source 15

Per-Zone Source Filtering

Enable per-zone source filtering

After setup

Host name or IP Address
Port
Serial device pathFor serial devices, prefer a stable path under /dev/serial/by-id/ over /dev/ttyUSBx.
Device name
Restore last known state when the device is offlineShow each zone's last known state instead of Unavailable while the amplifier is off. Home Assistant will mark these entities as assumed state, because a zone changed at the keypad while Home Assistant was down will read incorrectly until the amplifier reconnects.
Zone 1
Zone 2
Zone 3
Zone 4
Zone 5
Zone 6
Zone 7
Zone 8
Zone 9
Zone 10
Zone 11
Zone 12
Zone 1
Zone 2
Zone 3
Zone 4
Zone 5
Zone 6
Zone 7
Zone 8
Zone 9
Zone 10
Zone 11
Zone 12
Source 1
Source 2
Source 3
Source 4
Source 5
Source 6
Source 7
Source 8
Source 9
Source 10
Source 11
Source 12
Source 13
Source 14
Source 15
Enable per-zone source filtering
Source 1
Source 2
Source 3
Source 4
Source 5
Source 6
Source 7
Source 8
Source 9
Source 10
Source 11
Source 12
Source 13
Source 14
Source 15

Texts from the code of theharshl/htd-home-assistant.

From the README

This integration adds support for the Home Theater Direct line of Whole House Audio to Home Assistant.
Auto-discovery via DHCP (MAC prefix A44F29* / A64F29*)
Per-zone power, volume, mute, and source selection
Zone and source names read automatically from the controller on connect
Customize zone and source names during setup or at any time via the integration's settings
Hide unused zones so only the zones you care about appear in Home Assistant
Per-zone source filtering — restrict which sources are selectable per zone
Per-zone Bass and Treble sliders (enabled by default) and a Balance slider (hidden by default)
Per-zone DND (Do Not Disturb) switch — controls party mode / all-zones-on exclusion (Lync only)
Device rename via the integration's settings — no need to delete and re-add
Serial (USB) or network connection

From the README of theharshl/htd-home-assistant, MIT License. Shortened.