KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #mcp #cli #rust #deepseek-harness

homebridge-tuya-ir

★ 57 Open GitHub ↗

Allows homebridge to control Tuya Smart IR based devices

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

</p>

# Homebridge Tuya IR
[![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
[![npm](https://img.shields.io/npm/v/homebridge-tuya-ir.svg)](https://www.npmjs.com/package/homebridge-tuya-ir)
![GitHub](https://img.shields.io/github/license/prasad-edlabadka/homebridge-tuya-ir)
[![npm](https://img.shields.io/npm/dt/homebridge-tuya-ir.svg)](https://www.npmjs.com/package/homebridge-tuya-ir)
![GitHub issues](https://img.shields.io/github/issues-raw/prasad-edlabadka/homebridge-tuya-ir)
![GitHub pull requests](https://img.shields.io/github/issues-pr-raw/prasad-edlabadka/homebridge-tuya-ir)

![GitHub contributors](https://img.shields.io/github/contributors-anon/prasad-edlabadka/homebridge-tuya-ir)
![GitHub last commit](https://img.shields.io/github/last-commit/prasad-edlabadka/homebridge-tuya-ir)

Control your Tuya Smart IR based devices in HomeKit. Also works with Smart Home IR Blaster. You can add multiple Smart IR device to single configuration.

## Supported Devices
* Air Conditioner (Only pre-configured vendor. No DIY devices)
* Fan (Pre-configured and DIY devices)
* Light (Pre-configured only. No DIY). Light supports only on-off and brightness control.
* DIY Devices. Each learned button will be added a switch.
* All other Pre-configured remotes will be added as switch to turn them on and off only. No other feature. (No DIY devices)

## Installation Instructions

#### Option 1: Install via Homebridge Config UI X:

Search for "Tuya IR" in [homebridge-config-ui-x](https://github.com/oznu/homebridge-config-ui-x) and install `homebridge-tuya-ir`.

#### Option 2: Manually Install:

```
sudo npm install -g homebridge-tuya-ir
```
## Add Smart IR and Remotes
Download Tuya Smart app and add your Smart IR device based on OEM documentation and add remotes you want to control using the Smart IR device.

## Create Tuya IoT Project
* Follow steps on [Tuya website](https://developer.tuya.com/en/docs/iot/Platform_Configuration_smarthome?id=Kamcgamwoevrx) to create your Tuya Cloud project and assign your devices to the project.
* Login to your Tuya IoT account and open the project. Each remote is shown as separate device.
* The Smart IR device will also be shown as a separate device.
* Copy the device ID for Smart IR and remotes as shown in the image below. You will need to these to configure the plugin.

## Authorization
> Tuya IoT Platform
You need to attach multiple services to your Tuya IOT project.
1. Search for "IR Control Hub Open Service" in Tuya IoT Platform Service
2. Subscribe to the service, authorize the project you are working on.

Repeat the steps for all the services in the following image
<img src="./docs/tuya_iot_platform.png">

## Configuration
> UI

1. Navigate to the Plugins page in [homebridge-config-ui-x](https://github.com/oznu/homebridge-config-ui-x).
2. Click the **Settings** button for the Tuya IR plugin.
3. Add your devices
4. Add device parameters
5. Restart Homebridge for the changes to take effect.

> Manual

1. Edit the config.json file to add your devices and parameters. 
2. Sample Configuration
```
"platforms": [
    {
        "name": "TuyaIR",
        "tuyaAPIClientId": "Your Tuya Client ID",
        "tuyaAPISecret": "Your Tuya API Secret",
        "deviceRegion": "eu",
        "smartIR": [
            {
                "deviceId": "xxxxxxx",
                "autoFetchRemotesFromServer": false,
                "configuredRemotes": [
                    {
                        "id": "xxxxxxx",
                        "diy": false,
                        "model": "Sample",
                        "brand": "Sample Brand"
                    },
                    {
                        "id": "xxxxxx",
                        "diy": false,
                        "model": "Sample",
                        "brand": "Sample Brand"
                    }
                ]
            }
        ],
        "platform": "TuyaIR"
    }
]
```
2. Restart Homebridge

## Known Issues

1. Tuya API doesn't always return devices added to Smart IR based on OEM hardware. Thus, you need to add them in your app and then provide IDs in the plugin configuration. This is configuruable in the configuration.

## Contributing

If you have new accessory logic for a new device, please add a function defined by manufacturer, and describe your changes in the readME file.

## Donating

Please donate to a local pet shelter, or food pantry. It's been a wild time, but we can do our part by helping others.

homebridge-tuya-ir

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README