# Broadlink MQTT IR Bridge

Broadlink MQTT IR Bridge is a self-hosted MQTT (Message Queuing Telemetry Transport) service that lets home-automation users record, store, and replay infrared and radio-frequency commands on supported Broadlink. It is open source and self-hosted, installable on Unraid and Docker Hub.

Canonical page: https://ourlocalhost.com/app/1878/broadlink-mqtt-ir-bridge

## Description

Broadlink MQTT IR Bridge is a self-hosted MQTT (Message Queuing Telemetry Transport) service that lets home-automation users record, store, and replay infrared and radio-frequency commands on supported Broadlink devices for network-based remote control.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

32/100 (Low), based on 4 of 5 factors.
- Maintained: 0 (last commit 908 days ago)
- Popular: 48 (238 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 75 (no serious findings)

## Links

- Unraid: https://ca.unraid.net/apps/broadlink-mqtt-ir-bridge-0omfnbs0x34w7g?q=Broadlink_MQTT_IR-Bridge
- Docker Hub: https://hub.docker.com/r/dmitriy/broadlink-mqtt
- GitHub: https://github.com/eschava/broadlink-mqtt

## Common questions

### Which Broadlink app should I use for the first Wi-Fi setup, and are there any apps to avoid?

Use the Broadlink e-control app or Broadlink Intelligent Home Center to connect the device to Wi-Fi. Avoid the BroadLink Universal TV Remote app because it is known to lock the device.

### How can I keep my own settings safe when updating the bridge?

Copy the default mqtt.conf contents into custom.conf and edit only custom.conf. custom.conf overrides mqtt.conf and is not overwritten during repository updates.

### Where are recorded IR commands stored for backup or migration?

Recorded commands are saved in the commands/ folder, and macros are saved in the macros/ folder. Keep those folders when backing up or moving the bridge.

### Can I connect more than one Broadlink device to the same bridge?

Multiple-device support is experimental; set device_type to multiple_lookup and define mqtt_multiple_subprefix_format so each device gets a different MQTT sub-prefix. The default setup is single-device operation.

---
Source: Our Local Host (https://ourlocalhost.com/app/1878/broadlink-mqtt-ir-bridge), the self-hosted and open-source app directory.
