Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/smarthomehub/smartir
Integration for Home Assistant to control climate, TV and fan devices via IR/RF controllers (Broadlink, Xiaomi, MQTT, LOOKin, ESPHome)
https://github.com/smarthomehub/smartir
broadlink chuangmiir esphome homeassistant iot lookin smarthome
Last synced: 7 days ago
JSON representation
Integration for Home Assistant to control climate, TV and fan devices via IR/RF controllers (Broadlink, Xiaomi, MQTT, LOOKin, ESPHome)
- Host: GitHub
- URL: https://github.com/smarthomehub/smartir
- Owner: smartHomeHub
- License: mit
- Created: 2019-02-17T12:48:40.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-08-20T17:48:15.000Z (4 months ago)
- Last Synced: 2024-12-17T13:04:02.021Z (14 days ago)
- Topics: broadlink, chuangmiir, esphome, homeassistant, iot, lookin, smarthome
- Language: Python
- Homepage:
- Size: 8.22 MB
- Stars: 2,104
- Watchers: 52
- Forks: 1,020
- Open Issues: 244
-
Metadata Files:
- Readme: docs/README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/smartHomeHub/SmartIR/releases/latest) [](https://github.com/custom-components/hacs)
## Overview
SmartIR is a custom integration for controlling **climate devices**, **media players** and **fans** via infrared controllers.
SmartIR currently supports the following controllers:
* [Broadlink](https://www.home-assistant.io/integrations/broadlink/)
* [Xiaomi IR Remote (ChuangmiIr)](https://www.home-assistant.io/integrations/remote.xiaomi_miio/)
* [LOOK.in Remote](http://look-in.club/devices/remote)
* [ESPHome User-defined service for remote transmitter](https://esphome.io/components/api.html#user-defined-services)
* [MQTT Publish service](https://www.home-assistant.io/docs/mqtt/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:
```
/
|-- custom_components/
| |-- smartir/
| |-- __init__.py
| |-- climate.py
| |-- fan.py
| |-- media_player.py
| |-- etc...
```
**(2)** Add the following to your configuration.yaml file.
```yaml
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:
```yaml
smartir:
check_updates: false
```
If you would like to get updates from the rc branch (Release Candidate), configure SmartIR as follows:
```yaml
smartir:
update_branch: rc
```
**(3)** Configure a platform.
### *HACS*
If you want HACS to handle installation and updates, add SmartIR as a [custom repository](https://hacs.xyz/docs/faq/custom_repositories/). 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](/docs/CLIMATE.md)
* [Media Player platform](/docs/MEDIA_PLAYER.md)
* [Fan platform](/docs/FAN.md)
## See also
* [Discussion about SmartIR Climate (Home Assistant Community)](https://community.home-assistant.io/t/smartir-control-your-climate-tv-and-fan-devices-via-ir-rf-controllers/)
* [SmartIR Chat on Telegram](https://t.me/smartHomeHub)
