homebridge-tuya

Homebridge-Tuya

Control your supported Tuya accessories locally in HomeKit

• Supported Device Types
• Installation Instructions
• Configuration
• Known Issues
• Troubleshooting
• Credits
• License
• Donating

Supported Device Types

Click the number next to your device to find the possible DataPoint "DP" values, then add as needed to your config.

• Air Conditioner¹
• Air Purifiers²
• Convectors³
• Dehumidifers⁴
• Dimmers⁵
• Fan⁶
• Fan v2⁷
• Garages⁸
• Heaters⁹
• Lights
  • On/Off¹⁰
  • Brightness¹¹
  • Color¹² (Hue, Saturation, Adaptive Lighting)
• Oil Diffusers¹³
• Outlets¹⁴
• Switches¹⁵

Note: Motion, and other sensor types don't behave well with responce requests, so they will not be added.

Installation Instructions

Option 1: Install via Homebridge Config UI X:

Search for "Tuya" in homebridge-config-ui-x and install homebridge-tuya.

Option 2: Manually Install:

sudo npm install -g homebridge-tuya

Configuration

UI

1. Navigate to the Plugins page in homebridge-config-ui-x.
2. Click the Settings button for the Tuya plugin.
3. Add your device types
4. Add device parameters¹⁰
5. Restart Homebridge for the changes to take effect.

Manual

1. Edit the config.json file to add your device types, and parameters.
2. Restart Homebridge

Known Issues

1. If your devices add, but you can't control them, make sure you entered the DataPoint "DP" values for your device.

Troubleshooting

1. Make sure the plugin is up-to date
2. Check for existing issues

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.

Credits

• AMoo-Miki - developer of the Tuya-Lan plugin which this plugin is based off.
• mxDanger - Plugin branding.
• CodeTheWeb - developer of TuyaApi, who gratiously provided this repo's name.
• Oznu - developer of Homebridge, added config.schema.json , fixed dependencies, and helped inspire this readME off his gsh plugin.

License

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.