Tuya, Smart Life
Tuya Ultimate
homebridge-tuya-ultimate · v2.7.2
CloudHomebridge 2.0
Adds Tuya Smart and Smart Life devices to HomeKit through QR account authorization and live cloud updates.
What it says it supports
Brands
- Tuya
- Smart Life
Devices it names
- lights
- switches
- outlets
- air conditioners
- fans
- curtains
- garage doors
- air purifiers
- humidifiers
- safety sensors
- locks
Shows up in Apple Home as from its README
- Lights
- Outlets
- Switches
- Buttons and Remotes
- Thermostats
- Air Conditioners and Heaters
- Air Purifiers
- Fans
- Humidifiers
- Windows and Coverings
- Garage Door Openers
- Locks
- Security Systems
- Doorbells
- Sensors
- Valves
Sensor readings in its code
What people report
Supports Tuya devices by category code: lights, switches, sockets, curtains, ACs, purifiers, thermostats and more. Appliances like vacuums and fridges have no mapping.
- Works18
- Requested1
- Won’t be supported2
The plugin’s own supported-device list
| Device | Status | What they said | Source |
|---|---|---|---|
| Tuya Air Conditioner (kt) | Works | Mapped to HomeKit Heater Cooler, humidifier, fanSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya Air Purifier (kj) | Works | Mapped to HomeKit Air PurifierSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya Ceiling Fan Light (fsd) | Works | Mapped to HomeKit Lightbulb and FanSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya Curtain Switch (clkg) | Works | Mapped to HomeKit Window CoveringSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya Dimmer (tgq) | Works | Mapped to HomeKit LightbulbSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya Fan (fs) | Works | Mapped to HomeKit FanSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya Garage Door Opener (ckmkzq) | Works | Mapped to HomeKit Garage DoorSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya Heater (qn) | Works | Mapped to HomeKit Heater CoolerSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya Humidifier (jsq) | Works | Mapped to HomeKit HumidifierSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya Irrigator (ggq) | Works | Mapped to HomeKit ValveSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya Light (dj/dsd) | Works | Mapped to HomeKit LightbulbSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya Pet Feeder (cwwsq) | Works | Mapped to HomeKit SwitchSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya Power Strip (pc) | Works | Mapped to HomeKit OutletSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya Socket (cz) | Works | Mapped to HomeKit OutletSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya Strip Lights (dd) | Works | Mapped to HomeKit LightbulbSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya Switch (kg/tdq) | Works | Mapped to HomeKit SwitchSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya Thermostat (wk) | Works | Mapped to HomeKit ThermostatSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya Thermostat Valve (wkf) | Works | Mapped to HomeKit ThermostatSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Ceiling fan with RGB ambiance light | Requested | Second RGB light on ceiling fan not exposed; device JSON suppliedSaved copyDevice Infomation JSON File [code] Detail Informations I have a ceiling fan with an RGB light in addition to a white light. I can change the RGB light using the Tuya app. Is it possible to add this light to HomeKit? Excerpt saved from GitHub on 2026-10-22. | Issue #1 · 2026-08 |
| Tuya Refrigerator, Washing Machine, Boiler categories | Won’t be supported | Categories listed without a Homebridge service mappingSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya Robot Vacuum (sd) | Won’t be supported | Category listed without a Homebridge service mappingSaved copySupported Tuya Devices First-class category name, second-class category name, and category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. This matrix lists explicit category handlers. Optional `capabilityAutoDetection` can conservatively route an otherwise unsupported category when it already exposes recognized standard datapoints, but it does not make every product in that category compatible. Required datapoints, units, firmware, and account permissions still apply. Lighting | Name | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
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 Sharing cloud via QR authorization
You’ll need
- Tuya Smart or Smart Life app User Code
Compatibility
| Verified by Homebridge | No |
|---|---|
| Homebridge versions | ^1.8.0 || ^2.0.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^20 || ^22 || ^24 || ^25 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | TuyaPlatform |
| License | MIT |
Community signals
| Downloads a week | 46 |
|---|---|
| Downloads a month | 279 |
| GitHub stars | 0 |
| Open issues | 2 |
| Closed issues | 1 |
| Last code push | 2026-08-10 |
| Latest version | 2.7.2 (2026-08-06) |
| First published | 2026-07-26 |
| Releases | 40 |
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
- Support depends on category and datapoints
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
- CarbonDioxideSensor
- CarbonMonoxideSensor
- ContactSensor
- Doorbell
- Fan
- Fanv2
- GarageDoorOpener
- HeaterCooler
- HumidifierDehumidifier
- HumiditySensor
- LeakSensor
- LightSensor
- Lightbulb
- LockMechanism
- MotionSensor
- OccupancySensor
- Outlet
- SecuritySystem
- SmokeSensor
- StatelessProgrammableSwitch
- Switch
- TemperatureSensor
- Thermostat
- Valve
- Window
- WindowCovering
