Skip to content
Homebridge TestFlight
Tuya

Tuya Plus

homebridge-tuya-plus · v4.2.0

Local + cloudHomebridge 2.0

Controls Tuya devices over LAN in HomeKit, with optional Tuya Cloud fallback.

What it says it supports

Brands

  • Tuya

Devices it names

  • Air conditioners
  • air purifiers
  • convectors
  • dehumidifiers
  • dimmers
  • fans
  • garage doors
  • heaters
  • irrigation systems
  • lights
  • oil diffusers
  • outlets
  • vertical blinds

Shows up in Apple Home as from its README

Sensor readings in its code

What people report

Local Tuya plugin with a documented list of device types and a few verified configs. New devices are requested by Tuya category and DP schema; the maintainer is considering Tuya-native categories.

  • Works6
  • Requested2

The plugin’s own supported-device list

DeviceStatusWhat they saidSource
ChangM Candle BulbWorksColored dimmable bulb with documented config
Saved copy
… many device configurations as possible. If you would like to contribute to this list, please fill out the following fields in the example configuration. Bulb, Colored, Dimmable -- ChangM Candle Bulb Purchase Link: Amazon Device config: [code] Bulb, Colored, Dimmable -- Smart Led Mood Light Purchase Link: Action (France) Device config: [code] Next Device

Excerpt saved from GitHub on 2026-10-22.

Wiki: Supported Devices.md
Graywind Smart Vertical BlindsWorksWhite-label Tuya, support added; needs Tuya IoT trial account and cloud
Saved copy
sorry, just saw this - must have missed an alert. I am happy with the blinds other than I am now using homekit and I need to use the tuya plugin and have a trial account with tuya IoT for them to work with homekit - and you need an internet connection to go thru their cloud. So, I also became a bit of an expert at roller blinds LOL. I ordered a few that I made a mistake and order them too long so I had to take them all apart and cut them down - still have to do that to a couple of others. They are well made, can't fault anything on them - but I have now found matter over thread motors - turns …

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2025-11
Igenix IG9901WIFI air conditionerWorksDocumented example; needs lowercase cold command phrase override
Saved copy
… data-points for each outlet (instructions) | |Barely Smart Power Strip|`Outlet`|Smart power strips that don't allow individual control of the outlets| |Air Conditioner|`AirConditioner` 6 |Cooling and heating devices (instructions) | |Heat Convector|`Convector` 7 |Heating panels (instructions) | |Simple Dimmer|`SimpleDimmer` 8 |Dimmer switches with power control (instructions) | |WLED Dimmer|`WledDimmer` 8 |Dimmer switches with power control, plus optional WLED brightness sync and preset-effect switches (instructions) | |Simple Heater|`SimpleHeater` 9 |Heating solutions with only temperature …

Excerpt saved from GitHub on 2026-10-22.

Wiki: Supported Device Types.md
Kogan KAPRA14WFGA air conditionerWorksDocumented example; uses COOL mode phrase by default
Saved copy
… data-points for each outlet (instructions) | |Barely Smart Power Strip|`Outlet`|Smart power strips that don't allow individual control of the outlets| |Air Conditioner|`AirConditioner` 6 |Cooling and heating devices (instructions) | |Heat Convector|`Convector` 7 |Heating panels (instructions) | |Simple Dimmer|`SimpleDimmer` 8 |Dimmer switches with power control (instructions) | |WLED Dimmer|`WledDimmer` 8 |Dimmer switches with power control, plus optional WLED brightness sync and preset-effect switches (instructions) | |Simple Heater|`SimpleHeater` 9 |Heating solutions with only temperature …

Excerpt saved from GitHub on 2026-10-22.

Wiki: Supported Device Types.md
Smart Led Mood Light (Action)WorksColored dimmable bulb with documented config
Saved copy
… fields in the example configuration. Bulb, Colored, Dimmable -- ChangM Candle Bulb Purchase Link: Amazon Device config: [code] Bulb, Colored, Dimmable -- Smart Led Mood Light Purchase Link: Action (France) Device config: [code] Next Device

Excerpt saved from GitHub on 2026-10-22.

Wiki: Supported Devices.md
Tuya devicesWorksOriginal Tuya plugin broke on HB 2.0; tuya-plus fork works
Saved copy
I had been using https://github.com/iRayanKhan/homebridge-tuya for the longest, though support kind of fell apart a while back. When I upgraded to HB v2.0, it completely broke. I moved to a newer fork called homebridge-tuya-plus, and it is working great so far! https://github.com/adrianjagielak/homebridge-tuya-plus#readme

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2026-05
Hombli Smart Christmas LightsRequestedNo light type works; user got on/off working and plans a pull request
Saved copy
Describe your device This is a 200 LED device for christmas decorations, with several options for blinking/steady/… and the choice between warm and cold white light. Partial Support? I could not make it work with any light related device type, getting the error message: `This plugin generated a warning from the characteristic 'On': characteristic value expected boolean and received undefined.` Device Schema The category is [code] The Data Model is [code] Additional context Can you give some hint on how I could add this device myself? Probably I just need a starting point for that…

Excerpt saved from GitHub on 2026-10-22.

Issue #22 · 2025-12
Lumary 6in Smart RGBAI Ultra-thin DownlightRequestedDual main white and RGB nightlight channels not supported by existing light types
Saved copy
Device Description The Lumary 6’’ Smart RGBAI Ultra-thin Downlight (Model: US-SD6E-1 V2) is a Tuya-based two-in-one recessed ceiling light featuring a main white light and an auxiliary RGB nightlight. The main light supports on/off, brightness, and color temperature (warm to cool white). The auxiliary light supports on/off, RGB color, and brightness. Both lights are controlled independently through different DPIDs. Partial Support? The plugin is able to control one of the lights (typically the auxiliary), but behavior is unreliable: Brightness and color temperature commands do not register …

Excerpt saved from GitHub on 2026-10-22.

Issue #11 · 2025-07

Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local + cloud

LAN-first Tuya protocol with optional cloud fallback

You’ll need

  • Device local keys
  • Tuya cloud credentials for fallback

Compatibility

Verified by HomebridgeNo
Homebridge versions^1.8.0 || ^2.0.0-beta.0
Homebridge 2.0Yes
Node.js^20.18.0 || ^22.10.0 || ^24.0.0
Settings in Homebridge UIYes
MatterNo
Platform nameTuyaLan
LicenseMIT

Community signals

Downloads a week113
Downloads a month954
GitHub stars19
Open issues10
Closed issues10
Last code push2026-10-08
Latest version4.2.0 (2026-10-08)
First published2025-07-04
Releases102

In ReReHome

Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.

Bridges get their own settings page listing the accessories behind them.

HomeKit services in its code

Found by scanning the published npm package. A plugin can register a service only for some devices.

  • AirPurifier
  • AirQualitySensor
  • Battery
  • ContactSensor
  • Doorbell
  • Fan
  • GarageDoorOpener
  • HeaterCooler
  • HumidifierDehumidifier
  • HumiditySensor
  • IrrigationSystem
  • LeakSensor
  • Lightbulb
  • LockMechanism
  • Outlet
  • ServiceLabel
  • Switch
  • TemperatureSensor
  • Valve
  • WindowCovering