broadlink-mqtt
An MQTT client that enables local network control of BroadLink smart home devices (IR/RF controllers, plugs, sensors, etc.) via Python.
What is broadlink-mqtt?
BroadLink-MQTT is a Python-based MQTT client that allows users to control BroadLink smart home devices locally over their network. It translates MQTT messages into device-specific commands, enabling integration with home automation platforms like Home Assistant without relying on BroadLink's cloud services. The project solves the problem of vendor lock-in and cloud dependency for BroadLink device owners.
Home automation enthusiasts and DIYers who own BroadLink devices and want to integrate them into a local, MQTT-based smart home system. It's also suitable for developers building custom automation scripts that require direct device control.
Developers choose BroadLink-MQTT because it provides a reliable, local control solution that enhances privacy and reduces latency compared to cloud-dependent alternatives. Its support for a wide range of BroadLink devices and flexible command modes makes it a versatile tool for complex automation scenarios.
Overview
MQTT client to control BroadLink devices
Use Cases
Best For
- Integrating BroadLink IR blasters with Home Assistant for TV and AC control
- Creating local automation routines for BroadLink smart plugs and power strips
- Monitoring environmental data from BroadLink A1 sensors via MQTT
- Automating curtain control with BroadLink-compatible Dooya motors
- Building custom RF command sequences for remote-controlled devices
- Setting up a self-hosted smart home system without cloud dependencies
Not Ideal For
- Users seeking a plug-and-play, app-based setup without technical configuration
- Projects requiring cloud access or integration with non-MQTT smart home platforms
- Large-scale deployments with dozens of devices where experimental multi-device support may falter
- Those who prefer official vendor support and seamless over-the-air updates
Pros & Cons
Pros
Operates entirely on the local network via MQTT, eliminating cloud dependencies and enhancing privacy, as emphasized in the project's philosophy.
Supports multiple BroadLink device types including IR/RF controllers, smart plugs, sensors, and curtain motors, detailed in the 'Supported devices' section.
Offers recording, replaying, and smart auto modes for IR/RF commands, plus macro execution, as explained in the RM2/RM3/RM4 section for complex automation.
Allows setting intervals for publishing sensor data like temperature and energy usage, enabling real-time monitoring via MQTT topics, as shown in device-specific configurations.
Cons
Support for multiple devices is labeled as experimental, which may lead to instability or incomplete functionality, as noted in the configuration section.
Requires manual installation of Python dependencies, MQTT broker configuration, and device connection steps, making it challenging for non-technical users.
The README assumes prior knowledge of MQTT and Python, with error messages like authentication failures or Python version issues indicating potential pitfalls for newcomers.
Frequently Asked Questions
Related Projects
harmony-api🗼 A simple server allowing you to query/control multiple local Harmony Home Hubs over HTTP or MQTT
lgtv2mqttInterface between LG WebOS Smart TVs and MQTT :tv:
kodi2mqttMQTT addon for Kodi Mediacenter
sonos2mqtt:speaker: Sonos mqtt controller. Control your speakers from your mqtt server. mqtt-smarthome insprired.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.