/homebridge-tuya-platform-local

Unofficial Homebridge plugin enabling local control of Tuya smart devices

Primary LanguageJavaScriptMIT LicenseMIT

This repo is a fork of iRayanKhan's homebridge-tuya plugin.

Since the original repo is no longer maintained, I have forked it to correct several errors.

I do not have a lot of time to maintain this repo either but will do my best to merge PRs and fix issues.


Homebridge-Tuya-Platform-Local

npm npm

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
  • Presence Sensor (ZY-M100)
  • 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

  • Eliran Sapir - updated fork of @iRayanKhan's work.
  • iRayanKhan - developer of the Tuya-Lan plugin wich is a fork of his work.
  • 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.