Skip to content
Homebridge TestFlight
Tuya

Tuya Platform Fork

homebridge-tuya-platform-talrhvfork · v2.0.41

VerifiedCloudHomebridge 2.0

Fork of the official Tuya Open API plugin adding valve, motion sensor, Zigbee curtain and Fingerbot support.

What it says it supports

Brands

  • Tuya

Devices it names

  • Tuya Open API devices
  • Fingerbot
  • Zigbee curtain switches

Shows up in Apple Home as from its README

Sensor readings in its code

What people report

Tuya cloud fork; lights and curtain switches work but colour temperature is reported inverted, white mode missing, cameras unsupported.

  • Works2
  • Partly works1
  • Not working1
  • Won’t be supported1
DeviceStatusWhat they saidSource
Tuya Multifunction Security AlarmWorksSupport added in version 2.0.38 and above
Saved copy
Add support for Tuya Tuya Security Alarm { "result": { "active_time": 1683100983, "category": "mal", "create_time": 1681991455, "custom_name": "Security Alarm ", "icon": "smart/icon/ay15500268672065IQ53/e34e9fa4032bbee6fe6c47f52a6358a4.jpg", "id": "", "ip": "", "is_online": true, "lat": "31.8000", "local_key": "", "lon": "34.7900", "model": "PG103/PG105/PG106/PG107/PG109", "name": "Multifunction alarm", "product_id": "gyitctrjj1kefxp2", "product_name": "报警主机V2.4", "sub": false, "time_zone": "+03:00", "update_time": 1702217205, "uuid": "" }, "success": true, "t": 1702372612857, "tid": …

Excerpt saved from GitHub on 2026-10-22.

Issue #10 · 2023-12
Tuya Zigbee double curtain switchWorksOnly one curtain showed; resolved after reinstalling Homebridge
Saved copy
ZigBee Double Curtain Switch reflected in Homebridge one Curtain switch. Actual problem: only one curtain switch appears in HomeBridge. Expected behavior 2 Curtain Switch reflected in HomeBridge Screenshots TuyaOpenAPI response: {"result":{"devices":[{"active_time":1701945569,"biz_type":18,"category":"clkg","create_time":1701945569,"icon":"smart/icon/ay1509430484182dhmed/0d80bf555eab1e84a881fcb23ed10057.png","id":"","ip":"","lat":"31.8000","local_key":"","lon":"34.7900","model":"QCSC420ZB-US","name":"Curtain …

Excerpt saved from GitHub on 2026-10-22.

Issue #9 · 2023-12
Novostella Bloom 100W lightPartly worksNo pure white mode from the Home app
Saved copy
Describe the bug Not sure if this is a bug, or a feature request. These lights (Novostella Bloom 100W) have a pure white mode set by simply switching to the white tab in SmartLife (screenshot 1). There's no way to get pure white from the Home app -would be nice to be able to do this. The other way to approximate white is to set the saturation to zero on the color tab in SmartLife (screenshot 2). In this case, using temp tab in Home app results in a quite orange or quite blue color (screenshots 3 and 4). Using the Color tab in Home App, some colored hue of white can be had using the middle …

Excerpt saved from GitHub on 2026-10-22.

Issue #6 · 2022-11
Tuya color-temperature lights (category dj)Not workingWarm/cool slider inverted in Home app on many Tuya lights
Saved copy
Happens with all the Tuya devices from several different manufacturers, but for example: { "active_time": 1648229533, "biz_type": 18, "category": "dj", "create_time": 1611450227, "icon": "smart/product_icon/dj.png", "id": "66382108bcddc2691ddb", "ip": "47.187.123.231", "lat": "32.9728", "local_key": "313c16be466ea4c8", "lon": "-96.9611", "name": "Hallway", "online": true, "owner_id": "33474261", "product_id": "isehgkqn5uqlrorl", "product_name": "RGBCW_BR95", "status": [ { "code": "switch_led", "value": false }, { "code": "work_mode", "value": "white" }, { "code": "bright_value", "value": 255 …

Excerpt saved from GitHub on 2026-10-22.

Issue #5 · 2022-11
GRiD Connect security camerasWon’t be supportedMaintainer says no camera support; doorbell and lock also missing
Saved copy
Hi there, I have a pair of GRiD Connect security cameras that are connected to the Tuya app without an issue. However, they don't show up in my HomeKit. The lights show up but my camera's, door bell and smart lock don't show up. What can I do to fix this please?

Excerpt saved from GitHub on 2026-10-22.

Issue #3 · 2022-09

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

Cloud

Tuya Open API cloud

You’ll need

  • Tuya IoT developer account

Compatibility

Verified by HomebridgeYes
Homebridge versions^1.6.0 || ^2.0.0-beta.0
Homebridge 2.0Yes
Node.js^18.20.4 || ^20.15.1 || ^22 || ^24
Settings in Homebridge UIYes
MatterNo
Platform nameTuyaPlatform
LicenseMIT

Community signals

Downloads a week6
Downloads a month48
GitHub stars4
Open issues7
Closed issues2
Last code push2026-06-15
Latest version2.0.41 (2026-03-22)
First published2022-01-03
Releases32

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.

Caveats from the README

  • Homebridge 2.0 ESM rewrite

HomeKit services in its code

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

  • AirPurifier
  • ContactSensor
  • Fanv2
  • GarageDoorOpener
  • HeaterCooler
  • LeakSensor
  • Lightbulb
  • MotionSensor
  • Outlet
  • SmokeSensor
  • Switch
  • Valve
  • WindowCovering