homebridge-tuya-plus

A community-maintained Homebridge plugin for controlling Tuya devices locally over LAN. Control your supported Tuya accessories locally in HomeKit, with an optional Tuya Cloud fallback for devices the LAN can't reach.

• Supported Device Types
• Supported Tuya Protocol Versions
• 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⁹
• Irrigation Systems / Sprinklers¹⁷ (multi-valve, per-zone timers, battery)
• Lights
  • On/Off¹⁰
  • Brightness¹¹
  • Color¹² (Hue, Saturation, Adaptive Lighting)
• Oil Diffusers¹³
• Outlets¹⁴
• Switches¹⁵
• Vertical Blinds¹⁶

Cloud fallback

The plugin is LAN-first — everything is controlled locally by default. If you add Tuya Cloud credentials in a top-level cloud block, it keeps a cloud session in the background and uses it as a fallback: each device is tried on the LAN first, and only falls back to the cloud when it can't be reached locally — a brief LAN hiccup, or hardware that never appears on the LAN at all (e.g. battery-powered "sleepy" devices). It's opt-in and local always comes first, and existing configs need no changes — so it's also a handy fix if some devices occasionally show as "No Response".

See the Tuya Cloud Setup guide for credentials and setup.

Installation Instructions

Option 1: Install via Homebridge Config UI X:

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

Option 2: Manually Install:

sudo npm install -g homebridge-tuya-plus

Bleeding-edge (dev) builds:

Every commit to main is automatically published to npm under the dev tag — a separate, unstable channel. To try the latest in-development build:

sudo npm install -g homebridge-tuya-plus@dev

These are versioned like 3.14.0-dev.<n> and may be unstable; use the default install above for production.

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.

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

• iRayanKhan - developer of the original homebridge-tuya plugin.
• 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.

Check out my other Homebridge plugins:

• homebridge-futurehome (npm)
• homebridge-tuya-plus (npm)
• homebridge-eqiva-swift-bridge (npm)
• homebridge-intex-plus (npm)
• homebridge-simple-router-status (npm)