70 lines
3.2 KiB
Markdown
70 lines
3.2 KiB
Markdown
[](https://github.com/kobimx/Infrarize/releases/latest) [](https://github.com/custom-components/hacs)
|
|
|
|
> ### ⚠️ Notice
|
|
> This project is a fork of [SmartIR](https://github.com/smartHomeHub/SmartIR), rebranded as **Infrarize** in compliance with the original project's guideline that its name not be used for forks or derivative works.
|
|
>
|
|
> Full credit to the original SmartIR authors and community for the underlying design and device code database.
|
|
|
|
## Overview
|
|
Infrarize is a custom integration for controlling **climate devices**, **media players**, **fans** and **lights** via infrared controllers.<br>
|
|
Infrarize 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.<br><br>
|
|
Don't forget to **star** the repository if you had fun!<br><br>
|
|
|
|
|
|
## 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/
|
|
| |-- infrarize/
|
|
| |-- __init__.py
|
|
| |-- climate.py
|
|
| |-- fan.py
|
|
| |-- light.py
|
|
| |-- media_player.py
|
|
| |-- etc...
|
|
```
|
|
**(2)** Add the following to your configuration.yaml file.
|
|
```yaml
|
|
infrarize:
|
|
```
|
|
|
|
Infrarize 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 Infrarize version is incompatible with your HA instance. You can disable this feature by setting Infrarize as follows:
|
|
```yaml
|
|
infrarize:
|
|
check_updates: false
|
|
```
|
|
|
|
If you would like to get updates from the rc branch (Release Candidate), configure Infrarize as follows:
|
|
```yaml
|
|
infrarize:
|
|
update_branch: rc
|
|
```
|
|
|
|
**(3)** Configure a platform.
|
|
|
|
### *HACS*
|
|
If you want HACS to handle installation and updates, add Infrarize 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.
|
|
<br><br>
|
|
|
|
|
|
## 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)
|
|
* [Light platform](/docs/LIGHT.md)
|
|
<br><br>
|
|
|
|
## See also
|
|
* [Discussion about the original SmartIR project (Home Assistant Community)](https://community.home-assistant.io/t/smartir-control-your-climate-tv-and-fan-devices-via-ir-rf-controllers/) — useful background on climate/TV/fan IR control patterns; not specific to this fork.
|