/homebridge-tuya

A Homebridge plugin to control Tuya devices locally.

Primary LanguageJavaScriptMIT LicenseMIT


Homebridge-Tuya

npm npm verified-by-homebridge

Control your supported Tuya accessories locally in HomeKit

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 Conditioner1
  • Air Purifiers2
  • Convectors3
  • Dehumidifers4
  • Dimmers5
  • Fan6
  • Fan v27
  • Garages8
  • Heaters9
  • Lights
    • On/Off10
    • Brightness11
    • Color12 (Hue, Saturation, Adaptive Lighting)
  • Oil Diffusers13
  • Outlets14
  • Switches15

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 parameters10
  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.