Home Assistant integration to manage climate systems, TVs, fans and lights using IR/RF controllers. Compatible with Broadlink, Xiaomi, MQTT, LOOKin and ESPHome
Python
2,848
824 commits
updated Jul 21, 2025
⚠️ Warning
You are free to fork, modify, and use the code in this repository in accordance with the applicable open-source license.
However, the name "SmartIR" must not be used in any capacity, especially for promoting, rebranding, or distributing your own fork or derivative works.
Please respect this guideline to preserve the original project's identity.
SmartIR is a custom integration for controlling climate devices, media players, fans and lights via infrared controllers.
SmartIR currently supports the following controllers:
More than 120 climate devices are currently supported out-of-the-box, mainly for the Broadlink controller, thanks to our awesome community.
Don't forget to star the repository if you had fun!
(1) Place the custom_components folder in your configuration directory (or add its contents to an existing custom_components folder).
It should look similar to this:
<config directory>/
|-- custom_components/
| |-- smartir/
| |-- __init__.py
| |-- climate.py
| |-- fan.py
| |-- light.py
| |-- media_player.py
| |-- etc...
(2) Add the following to your configuration.yaml file.
smartir:
SmartIR automatically detects updates after each HA startup and asks you to install them. It also has a mechanism that prevents you from updating if the last SmartIR version is incompatible with your HA instance. You can disable this feature by setting SmartIR as follows:
smartir:
check_updates: false
If you would like to get updates from the rc branch (Release Candidate), configure SmartIR as follows:
smartir:
update_branch: rc
(3) Configure a platform.
If you want HACS to handle installation and updates, add SmartIR as a custom repository. In this case, it is recommended that you turn off automatic updates, as above.
Click on the links below for instructions on how to configure each platform.
375 followers · starred Mar 2023
2,206 followers · starred Feb 2020
261 followers · starred Nov 2020
156 followers · starred Mar 2025
Home Assistant integration to manage climate systems, TVs, fans and lights using IR/RF controllers. Compatible with Broadlink, Xiaomi, MQTT, LOOKin and ESPHome
Python
2,848
824 commits
updated Jul 21, 2025
⚠️ Warning
You are free to fork, modify, and use the code in this repository in accordance with the applicable open-source license.
However, the name "SmartIR" must not be used in any capacity, especially for promoting, rebranding, or distributing your own fork or derivative works.
Please respect this guideline to preserve the original project's identity.
SmartIR is a custom integration for controlling climate devices, media players, fans and lights via infrared controllers.
SmartIR currently supports the following controllers:
More than 120 climate devices are currently supported out-of-the-box, mainly for the Broadlink controller, thanks to our awesome community.
Don't forget to star the repository if you had fun!
(1) Place the custom_components folder in your configuration directory (or add its contents to an existing custom_components folder).
It should look similar to this:
<config directory>/
|-- custom_components/
| |-- smartir/
| |-- __init__.py
| |-- climate.py
| |-- fan.py
| |-- light.py
| |-- media_player.py
| |-- etc...
(2) Add the following to your configuration.yaml file.
smartir:
SmartIR automatically detects updates after each HA startup and asks you to install them. It also has a mechanism that prevents you from updating if the last SmartIR version is incompatible with your HA instance. You can disable this feature by setting SmartIR as follows:
smartir:
check_updates: false
If you would like to get updates from the rc branch (Release Candidate), configure SmartIR as follows:
smartir:
update_branch: rc
(3) Configure a platform.
If you want HACS to handle installation and updates, add SmartIR as a custom repository. In this case, it is recommended that you turn off automatic updates, as above.
Click on the links below for instructions on how to configure each platform.
375 followers · starred Mar 2023
2,206 followers · starred Feb 2020
261 followers · starred Nov 2020
156 followers · starred Mar 2025