SmartIR

⚠️ 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.

Overview

SmartIR is a custom integration for controlling climate devices, media players, fans and lights via infrared controllers. SmartIR currently supports the following controllers:

• Broadlink
• Xiaomi IR Remote (ChuangmiIr)
• LOOK.in Remote
• ESPHome User-defined service for remote transmitter
• MQTT Publish service

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!

Installation

Manual

(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.

HACS

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.

Platform setup instructions

Click on the links below for instructions on how to configure each platform.

• Climate platform
• Media Player platform
• Fan platform
• Light platform

See also

• Discussion about SmartIR Climate (Home Assistant Community)