MuPiBox Documentation MuPiBox Classic

MQTT and Home Assistant

Over MQTT the box reports its state to a broker in your home network and can be controlled through it. With Home Assistant the box sets itself up ther…

Over MQTT the box reports its state to a broker in your home network and can be controlled through it. With Home Assistant the box sets itself up there. The settings are under Settings › Services › MQTT / Home Assistant.

Connection

SettingMeaning
MQTT activeswitches the connection on (off after installation)
Device namethe name under which the box appears
Brokeraddress of the MQTT broker
Portthe broker's port, 1883 is usual
Topiccommon beginning of all the box's topics
Client IDthe box's identifier at the broker
User and Passwordif the broker requires them

Intervals

SettingEffect
Update (playback)how often the box reports during playback, 1 to 90 seconds
Update (idle)how often it reports when nothing is playing, 1 to 90 seconds
Timeoutwaiting time for the broker, 10 to 180 seconds

Home Assistant

With Report to Home Assistant the box creates its devices in Home Assistant by itself (MQTT discovery). The discovery prefix must match what is set in Home Assistant (there it is normally called homeassistant).

© 2026 MuPiBox