About
Xtend Tuya is an integration that adds entities missing from the core Tuya integration in Home Assistant. It can run alongside the core Tuya integration, adding entities to the devices that one provides, or on its own, supplying all devices and entities itself. It adds entities needed by the Energy dashboard and support for locks, which needs extra configuration. Covered platforms include sensors, switches, numbers, selects, covers, climate, cameras, vacuums and valves, plus actions for camera streams, WebRTC, API calls and irrigation timers. Optional Tuya cloud credentials can be entered to bring in more entities, and several Tuya accounts can be added as separate hubs. It needs the vendor's cloud and is set up in the UI.
Automatic summary of the README and code of azerty9971/xtend_tuya. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Uses the vendor's cloud Needs an internet connection and an account with the vendor.
Found by itself Home Assistant spots it on the network and offers to add it.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Lights
- Climate
- Humidifiers
- Fans
- Covers
- Cameras
- Locks
- Alarms
- Remotes
- Vacuums
- Switches
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Connect
- User code
Also asked when signing in again.
Ir add key
- New key display nameThe display text of the new key that will be added to the IR device.
- New key technical nameThe technical name of the new key that will be added to the IR device.
Ir add device
- New device name
Add Tuya OpenAPI credentials
- Don't ask for OpenAPI credentials
- Country
- Tuya IoT Access ID
- Tuya IoT Access Secret
- SmartLife/Tuya account
- SmartLife/Tuya account password
After setup
- Don't ask for OpenAPI credentials
- Country
- Tuya IoT Access ID
- Tuya IoT Access Secret
- SmartLife/Tuya account
- SmartLife/Tuya account password
- Device
- Don't ask for OpenAPI credentials
- Country
- Tuya IoT Access ID
- Tuya IoT Access Secret
- SmartLife/Tuya account
- SmartLife/Tuya account password
- Device
- Device
- Device
- Current temperature multiplier
- Current humidity multiplier
- Target temperature multiplier
- Target humidity multiplier
- Invert the control of the device
- Invert the reported status of the device
- Time from opened to closed (seconds)
- Status refresh interval
- Force use of virtual position
- Device doesn't support precise positioning
Texts from the code of azerty9971/xtend_tuya.
Entities
- Binary sensorsBattery charging, Cleaning, Number of cleaning, Door contact, Door contact 2, Door contact 3, Error, and 32 more
- ButtonsChange litter bag, Clear energy, Deep clean, Empty litter box, Factory reset, Filter reset, and 14 more
- ClimateMode
- CoversCurtain 2, Curtain 3, Door, Door 2, Door 3, Blind, and 2 more
- EventsLock alarm, Movement detected, Device notifications
- LightsLight 2, Light 3, Backlight, Light, Night light
- LocksOperate lock
- NumbersAlarm time, Auto lock time, Max breath detection distance, Min breath detection distance, Breath detection sensitivity, Micro-motion detection upper limit, and 120 more
- SelectsAlarm volume, Beep volume, Manual shoveling, Manual dumping, Status, Cleaning mode, and 52 more
- SensorsCurrent A, Voltage A, Grid Frequency, Grid current, Active power, Active power A, and 260 more
- SwitchesAlarm 1, Alarm 2, Alarm 3, Alarm 4, Alarm switch, Auto clean, and 120 more
- TimesCountdown 1, Countdown 2, Countdown 3, Countdown 4, Countdown 5, Countdown 6, and 2 more
- ValvesValve
Actions
- Get camera stream URLGet camera stream URLFields: Device ID, Source, Stream type
- Call APICall an API and return the resultFields: Source, Method, URL, Payload
- Get ICE servers (WebRTC)Get the ICE servers needed for a WebRTC connectionFields: Device ID, Session ID, Source, Format
- SDP exchange (WebRTC)Perform a WebRTC SDP exchangeFields: Device ID, Session ID, Source, Channel
- Debug WebRTCGet the traces of the WebRTC communicationFields: Session ID, Source
- ToggleToggles (enable / disable) an automation.
- TriggerTriggers the actions of an automation.Fields: Skip conditions
- ReloadReloads the automation configuration.
- Set fdm5kw irrigation timerWrite a scheduled irrigation timer into one slot of a QT-08W valve.Fields: Device ID, Slot, Hour, Minute, Mode, Value, Days, Enabled
- Delete fdm5kw irrigation timerRemove a scheduled irrigation timer from a QT-08W valve.Fields: Device ID, Slot, Hour, Minute, Days
- Start fdm5kw wateringOpen a QT-08W valve for a single run, stopping after a duration or a volume.Fields: Device ID, Mode, Value
- Stop fdm5kw wateringClose a QT-08W valve and end the current run.Fields: Device ID
- Clear fdm5kw cloud-timer quota lockoutReset the circuit breaker that suppresses Tuya cloud-timer writes after a 60001001 'controllable device pool quota insufficient' error. Call this after upgrading the IoT Core plan or removing devices so the next timer change retries the cloud write. Writes that go straight to the device were never affected by the lockout.
- Resync fdm5kw timers from cloudReconcile the Home Assistant timer registry for one valve against the Tuya cloud and drop slots the cloud no longer knows about. Disabled leftovers are dropped without a device write; an enabled orphan slot, which would otherwise water unattended, is cleared with a device write that costs one controllable-device unit. Returns the reconcile counts.Fields: Device ID
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
- Repair noticesNotices it can show in Settings, Repairs:Tuya vacuum support for vacuum.turn_off is being removed, Tuya vacuum support for vacuum.turn_on is being removed, Tuya OpenAPI request failed, Tuya OpenAPI credentials expired, Tuya OpenAPI account not configured, Tuya OpenAPI account badly configured (lock), Tuya OpenAPI account badly configured (camera), Tuya OpenAPI account badly configured (IR), Tuya OpenAPI account badly configured (Energy stat), Tuya OpenAPI MQTT Not authorized
From the README
Extended Tuya integration for Home Assistant.
- Adds entities needed by the Energy dashboard
- Adds support for locks (requires additional configuration)
- Much more...
Shows in Vulpo
Light card, Quick Toggle card, Cover card, Climate card, Apple Watch, Control Center, Climate Live Activity, Vacuum Live Activity.Information
- Installs
- 3.4k sharing analytics
- GitHub stars
- 365
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- v4.5.3,
- Category
- Hubs and protocols, Smart home hubs
- Kind
- Marketplace integration
- Brand
- Tuya
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
xtend_tuya- Issues
- Report an issue
More from Tuya
Tuya Smart IR AC1k installs · Control Tuya IR based air conditioners and generic devices from H…Open
LocalTuyaIR Remote Control467 installs · Tuya universal remote control device Home Assistant integrationOpen










