[APP][Pro] Universal TUYA Zigbee - Local-First Control
GitHub: GitHub - dlnraja/com.tuya.zigbee: new updated version
Test app homey page: Universal Tuya Zigbee | Homey
** Device finder helper comming soon **: Universal Tuya Zigbee - Smart Device Finder
Version: 3.1.1+
Status: Active Development | Test Phase
Introduction
Welcome to Universal TUYA Zigbee — a community-driven project focused on bringing reliable, local Zigbee control to Tuya devices (and compatible brands) on Homey Pro, using SDK v3.
This app is built with one core principle: Local-first. No cloud required for daily operation, maximum responsiveness, and full offline capability.
Why This App?
Many Tuya Zigbee devices work great locally when properly supported. This project aims to:
Maximize local Zigbee compatibility (TS0601, TS011F, TS0202, and 100+ other models)
Organize by function, not brand (find devices by what they do)
Provide transparency (open source, CI/CD, device matrix, changelogs)
Stay humble and collaborative — this project complements other Tuya apps
Respect for the Ecosystem
This app exists alongside other excellent solutions:
-
Tuya Zigbee (Johan Bendz) — stable, proven, excellent foundation
-
Tuya Cloud (Athom) — perfect for Wi-Fi devices needing cloud access
-
Other Zigbee apps — each serving different needs
Our focus: Local Zigbee control, universal compatibility, transparent development.
We’re not competing — we’re complementing the ecosystem with a specific approach.
Local-first Zigbee — No Internet required for normal operation
Universal by function — Drivers organized by category (sensors, switches, covers, etc.)
TS0601 DP Engine — Smart handling of Tuya’s complex datapoint system
IAS Zone support — Motion sensors, SOS buttons, alarms work reliably
Multi-brand compatible — Tuya, MOES, BSEED, Lonsonho, Nedis, LSC, and many more
Transparent development — CI/CD validation, public device matrix, open changelogs
Active maintenance — Regular updates, bug fixes, new device support
Supported Devices (383+ Manufacturer IDs)
Switches & Plugs
-
On/Off: TS0001, TS0002, TS0003, TS0004 (1-4 gang)
-
Smart Plugs: TS011F, TS0121 (with/without energy monitoring)
-
EU/UK/US variants: Multiple socket types supported
Lights & Dimmers
-
Dimmers: TS110F, TS1111, rotary dimmers
-
Bulbs: White, RGB, CCT (color temperature)
-
LED Strips: Various lengths and types
Contact & Motion Sensors
-
Contact: TS0203, RH3001, door/window sensors
-
Motion: TS0202, PIR sensors, occupancy detection
-
Multi-sensors: Motion + temp + humidity + illumination
Climate & Environment
-
Temp/Humidity: TS0201, TS0601 variants
-
Thermostats: TRV valves, multi-mode control
-
Air Quality: CO2, CO, gas, formaldehyde sensors
-
Soil: Moisture + temperature sensors
Covers & Curtains
-
Motors: TS130F, TZE200 variants
-
Blinds: Roller, Venetian
-
Position control: 0-100% with tilt support
Safety & Security
-
IAS Zone: Motion, SOS buttons (v3.0.61 critical fix applied)
-
Alarms: Smoke, CO, gas, water leak
-
Sirens: Indoor/outdoor, adjustable volume
Scene & Control
-
Scene switches: TS004F (1-4 button), wireless
-
Remotes: Multi-button controllers
-
Knobs: Rotary control, dimming
Battery-Powered
-
CR2032: Contact sensors, buttons
-
CR2450: Scene switches, remotes
-
AAA/AA: Various sensors
v3.1.1 (Current) 
-
+272 new manufacturer IDs (111 → 383)
-
Advanced enrichment system (7 internet sources)
-
Micro-modules for API bypass, smart matching, caching
-
Complete automation system (GitHub Actions + Windows batch)
-
100% test coverage (27/27 tests passed)
-
Validation: PASSED (publish level)
v3.0.64
-
Flow card management improvements
-
Refactoring and stability fixes
v3.0.61 (Critical) 
-
IAS Zone proactive enrollment (motion + SOS fixed)
-
Fixed malformed try-catch blocks
-
Battery reporting improvements
-
Major stability update for all IAS devices
v3.0.60
-
TS0601 improvements
-
DP Engine enhancements
v3.0.55
-
Profiles system introduction
-
Capability mapping improvements
v3.0.50
-
Major TS0601 overhaul
-
Multi-mode support (thermostats, covers)
See full changelog: GitHub Releases
Roadmap
Completed
-
SDK3 migration
-
IAS Zone critical fix
-
TS0601 DP engine
-
Device matrix automation
-
CI/CD pipeline
-
Multi-source enrichment
In Progress
-
AI-assisted device detection
-
Dynamic capability mapping
-
Enhanced Flow cards
-
Multi-language docs
Planned
-
Community device profiles (JSON-based)
-
Auto-repair capabilities
-
Smart fallback strategies
-
Telemetry (opt-in, anonymous)
Installation (GitHub)
git clone https://github.com/dlnraja/com.tuya.zigbee
cd com.tuya.zigbee
npm install
homey app validate --level publish
homey app run
Device Matrix
See supported devices: Device Matrix
Found an unsupported device? Please provide:
Manufacturer Name (from Homey Developer Tools)
Model ID (e.g., TS0601, TS011F)
Product photos (box, label with model number)
Where to buy (link to Amazon, AliExpress, etc.)
Pairing logs (from Homey)
Zigbee2MQTT link (if available)
DP list (for TS0601 devices)
Create an issue: GitHub Issues
Help us debug issues! Here’s how:
Method 1: Homey CLI
homey app log
Copy the output and paste in your issue.
Method 2: Homey Developer Tools
-
Open Homey app → Settings → Apps → Universal TUYA Zigbee
-
Click device → More → Developer Tools
-
Copy logs from the console
-
Share in GitHub issue
What to include:
-
Device model and manufacturer
-
What’s not working (expected vs actual behavior)
-
Error messages (if any)
-
Screenshots (if relevant)
Where to Buy Supported Devices
AliExpress: Search for model number (TS011F, TS0601, etc.)
Amazon: “Tuya Zigbee” + device type
Local stores: Nedis, LSC Smart Connect (Action), Lidl Smart Home
Tip: Look for “Zigbee 3.0” logo on packaging!
Support This Project
This app is developed in my free time, powered by passion and AI assistance.
If you find it useful and want to support continued development:
PayPal: @dlnraja
Revolut: Revolut.Me Link
100% optional — your feedback and bug reports are equally valuable! ![]()
Community & Feedback
Your input makes this project better:
Test new features and report issues
Share device fingerprints for unsupported models
Suggest improvements via GitHub Discussions
Help others in the forum
Contribute code (PRs welcome!)
Important Links
GitHub: GitHub - dlnraja/com.tuya.zigbee: new updated version
Device Matrix: MANUFACTURER_DATABASE.json
Report Issues: GitHub Issues
Forum: You’re here!
CI/CD: GitHub Actions
Documentation: Docs folder
SDK: Homey SDK v3
Architecture: Modular DP engine + profiles + traits
Validation: Automated CI/CD (publish level)
Test Coverage: 27/27 tests (100%)
Drivers: 183
Manufacturer IDs: 383+
Languages: English, French (docs)
License: GPL-3.0
Special thanks to:
-
Johan Bendz — for the original Tuya Zigbee foundation
-
Homey Community — for testing, feedback, and patience
-
Contributors — for bug reports and suggestions
-
You — for being here and supporting local-first smart home!
Test Phase: This app is actively developed and tested.
Stability: Production-ready for most devices (v3.1.1+)
Support: Active via GitHub issues and forum
Updates: Frequent (check GitHub for latest)
Final Words
This project is about choice: choosing local control, choosing transparency, choosing community-driven development.
It’s not about being “the best” — it’s about being complementary, open, and useful.
If you value these principles, welcome aboard! ![]()
Let’s build something great together. ![]()
Dylan Rajasekaram
Developer & Maintainer
“Made with
,
, and
in my free time”
