Tuya (QR login)
homebridge-tuya-without-developer-account · v1.1.1
Adds Tuya and Smart Life devices to HomeKit using QR cloud authentication without a developer account.
What it says it supports
Brands
- Tuya
- Smart Life
Devices it names
- Pet feeder
- blinds
- AC
- multi-channel switches
- outlets
Shows up in Apple Home as from its README
- Lights
- Outlets
- Switches
- 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 many Tuya categories (lights, switches, sockets, fans, blinds) through a doc list; the maintainer fixes data-point mappings quickly when users report models.
- Works6
- Partly works1
- Won’t be supported1
The plugin’s own supported-device list
| Device | Status | What they said | Source |
|---|---|---|---|
| Tuya 6-speed fan | Works | Fan speed showed 1-5 then wrong percent; fixed after updateSaved copyHi Kosztyk, My fans have 6 speeds. In Apple HomeKit, it shows 1%, 2%, 3%, 4%, and 5%. The 6 setting is missing. Is this something that can be fixed? Here are the logs when I switch from 1 to 6. When my fan is set to 6, HomeKit shows 100%. [14/08/2026, 09:46:22] [Tuya without developer account] [TuyaHADeviceManager] [TuyaHASharingMQ] Tuya HA MQTT message: {"protocol":4,"data":{"devId":"eb8bf064353e1f93d6k9vo","dataId":"ac2a77d5-3361-486a-86aa-f13345e7b0dd","productKey":"atfenlerda169ygw","status":[{"62":1,"code":"fan_speed","t":1786715182595,"value":1}]},"t":1786715182933} [14/08/2026, … Excerpt saved from GitHub on 2026-10-22. | Issue #10 · 2026-08 |
| Tuya blinds/curtain motor | Works | Stop button requested; tap-to-stop behavior added in latest versionSaved copyRight now, you can either click to open/close all the way or choose a specific location using the slder (pic 1). It would be great to have a button to stop it at anytime. I attached an image (pic 2) of how it works for my other device as example Excerpt saved from GitHub on 2026-10-22. | Issue #8 · 2026-08 |
| Tuya DP10 Smart dimmer plug | Works | Showed Not Supported; fixed by mapping bright_value_v2 and switch_ledSaved copyThanks, the screenshots help. The Home app showing Not Supported means the plugin is not exposing this dimmer plug as a valid HomeKit Lightbulb service. The device model is shown as DP10 Smart dimmer Plug, so I need to add/fix the Tuya DP mapping for this type of dimmer plug. Basic lights and outlets working means QR auth and normal command sending are OK; this is specifically a dimmer-plug mapping issue. Can you please send me the Homebridge startup log lines around `Patio Lights`? You can get them with: [code] If possible, also send the cached Tuya device JSON for that device, because I … Excerpt saved from GitHub on 2026-10-22. | Issue #2 · 2026-05 |
| Tuya light, strip, ceiling light, dimmer | Works | Listed as supported Lightbulb categoriesSaved copySupported Tuya Devices First-class category name, sedond-class category name, category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. Lighting | Name | Name (zh) | Code | Homebridge Service | Supported | Links | | ---- | ---- | ---- | ---- | ---- | ---- | | Light | 光源 | dj dsd | Lightbulb | ✅ | Documentation | | Ceiling Light | 吸顶灯 | xdd | Lightbulb | ✅ | Documentation | | Ambiance Light | 氛围灯 | fwd | Lightbulb | ✅ | Documentation | | String Lights | 灯串 | dc | Lightbulb | ✅ | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya qxj weather station sensor | Works | PR adds temp_current and humidity_value datapoints; closedSaved copyThanks for the contribution and for testing this on a real qxj device. The underlying idea is good and I do want to support these datapoints, but I’d like a couple of changes before merging because the current matching is slightly too broad and could produce incorrect HomeKit values on other Tuya devices. The first issue is this condition: schema.code.startsWith('temp_current') That will correctly match: temp_current temp_current_external but it can also match other Tuya datapoints that begin with the same prefix, for example: temp_current_f which is typically a Fahrenheit temperature … Excerpt saved from GitHub on 2026-10-22. | PR #11 · 2026-09 |
| Tuya switch, socket, power strip | Works | Listed as supported Switch/Outlet categoriesSaved copySupported Tuya Devices First-class category name, sedond-class category name, category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. Lighting | Name | Name (zh) | Code | Homebridge Service | Supported | Links | | ---- | ---- | ---- | ---- | ---- | ---- | | Light | 光源 | dj dsd | Lightbulb | ✅ | Documentation | | Ceiling Light | 吸顶灯 | xdd | Lightbulb | ✅ | Documentation | | Ambiance Light | 氛围灯 | fwd | Lightbulb | ✅ | Documentation | | String Lights | 灯串 | dc | Lightbulb | ✅ | … Excerpt saved from GitHub on 2026-10-22. | Docs: SUPPORTED_DEVICES.md |
| Tuya IR air conditioner remote (infrared_ac) | Partly works | Shows empty accessory in QR mode; open PR adds local IR hub stateSaved copySummary In QR mode, IR AC remotes (`infrared_ac`) currently show up as an empty accessory. The QR cloud has no `remote_keys` and no IR Control Hub API, so `IRAirConditionerAccessory` gets no modes and no temperature range, and it can't send commands. This PR adds `IRAirConditionerHAAccessory`, which extends `IRAirConditionerAccessory`: Commands: sent with the remote's QR functions `PowerOn` / `PowerOff` / `M` / `T` / `F` through `/v1.1/m/thing/{id}/commands`. Only changed settings are sent, one function per request, because the QR cloud rejects several IR AC functions in one request (`1109`). … Excerpt saved from GitHub on 2026-10-22. | PR #16 · 2026-10 |
| Tuya remote control (ykq) | Won’t be supported | Category listed without a supported markSaved copySupported Tuya Devices First-class category name, sedond-class category name, category code can be found here: https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq Most category code is pinyin abbreviation of Chinese name. Lighting | Name | Name (zh) | Code | Homebridge Service | Supported | Links | | ---- | ---- | ---- | ---- | ---- | ---- | | Light | 光源 | dj dsd | Lightbulb | ✅ | Documentation | | Ceiling Light | 吸顶灯 | xdd | Lightbulb | ✅ | Documentation | | Ambiance Light | 氛围灯 | fwd | Lightbulb | ✅ | Documentation | | String Lights | 灯串 | dc | Lightbulb | ✅ | … 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 cloud via QR authentication
You’ll need
- Tuya or Smart Life app account
Compatibility
| Verified by Homebridge | No |
|---|---|
| Homebridge versions | ^1.8.0 || ^2.0.0-beta.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^20 || ^22 || ^24 || ^25 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | TuyaNoDeveloperAccount |
| License | MIT |
Community signals
| Downloads a week | 286 |
|---|---|
| Downloads a month | 1,374 |
| GitHub stars | 8 |
| Open issues | 1 |
| Closed issues | 13 |
| Last code push | 2026-10-22 |
| Latest version | 1.1.1 (2026-10-22) |
| First published | 2026-05-17 |
| Releases | 54 |
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
- No native Pet Feeder tile in Apple Home
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
- ConfiguredName
- ContactSensor
- Doorbell
- Fan
- Fanv2
- GarageDoorOpener
- HeaterCooler
- HumidifierDehumidifier
- HumiditySensor
- LeakSensor
- LightSensor
- Lightbulb
- LockMechanism
- MotionSensor
- Name
- OccupancySensor
- Outlet
- SecuritySystem
- SmokeSensor
- StatelessProgrammableSwitch
- Switch
- TemperatureSensor
- Thermostat
- Valve
- Window
- WindowCovering
Sources
- npm: https://www.npmjs.com/package/homebridge-tuya-without-developer-account
- Source code: https://github.com/Kosztyk/homebridge-tuya-without-developer-account
- Issues: https://github.com/Kosztyk/homebridge-tuya-without-developer-account/issues
- Homepage: https://github.com/kosztyk/homebridge-tuya-without-developer-account#readme





