prasad-edlabadka / homebridge-tuya-ir

Allows homebridge to control Tuya Smart IR based devices
Apache License 2.0
53 stars 21 forks source link

Homebridge Tuya IR

verified-by-homebridge npm GitHub npm GitHub issues GitHub pull requests

GitHub contributors GitHub last commit

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

Installation Instructions

Option 1: Install via Homebridge Config UI X:

Search for "Tuya IR" in 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

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

Configuration

UI

  1. Navigate to the Plugins page in 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"
    }
    ]
  3. 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.