homebridge-tuya-matter
v1.0.0-beta.11
Published
The Next-Generation Tuya Integration.
Downloads
1,003
Maintainers
Readme
🏠 homebridge-tuya-matter
The Next-Generation Tuya Integration
homebridge-tuya-matter is a high-performance, modern rewrite of the legacy Tuya platform. Rebuilt from the ground up with clean syntax and optimized logic, it introduces Native Matter Bridging for your Tuya ecosystem, delivering faster local-first execution and superior stability.
[!TIP] Broad Compatibility: While engineered for the future of Matter (Homebridge 2.0+), this plugin is designed to support Homebridge 1.3+ for standard HAP operation. Note: Legacy support for 1.3+ is currently experimental/untested and does not include Matter features.
🚀 Key Improvements
- Native Matter Stack: Bridges your devices directly via the Homebridge 2.0 Matter Controller.
- Modern ESM Rewrite: A clean-sheet codebase using modern JavaScript, discarding years of legacy technical debt.
- Enhanced Device Logic: Specialized support for Fingerbots, ZigBee Curtain Switches (clkg), and improved multi-channel relays.
🛠 Installation (Homebridge UI)
- Tuya Developer Platform Setup (Required) Before installing the plugin, you must configure a cloud project to obtain your Access ID and Access Key.
Please follow the official step-by-step instructions here: 👉 https://developer.tuya.com/en/docs/iot/Tuya_Homebridge_Plugin?id=Kamcldj76lhzt
[!WARNING] Important Note: Follow the steps in the link above ONLY to set up your cloud project and obtain your credentials. Ignore the section titled "Install the Homebridge plugin of Tuya" in that documentation. That refers to the legacy Tuya plugin. You are here to install the next-generation homebridge-tuya-matter instead!
[!IMPORTANT] Ensure you have linked your Tuya/SmartLife app account to your cloud project as described in the guide, or your devices will not appear in Homebridge.
- Plugin Installation (Homebridge UI) A. Once you have your credentials, the easiest way to install the plugin is through the official Homebridge Web Interface: B. Open your Homebridge dashboard. C. Navigate to the Plugins tab. D. Search for homebridge-tuya-matter. E. Click Install. F. Restart Homebridge and follow the configuration steps in the UI.
Note: Since this is currently in beta, look for the version tagged as @beta in the search results if you want the latest Matter features.
📜 Disclaimer & Credits
homebridge-tuya-matter is an independent project developed by Tal Rahav.
Credits: This plugin is based on the foundation of the official Tuya Homebridge Platform but has been completely rewritten and expanded with modern features.
Disclaimer: This is not an official product of Tuya Inc. Use this software at your own risk.
Beta Notice: Native Matter support requires Homebridge v2.0.0-beta.75 or higher. While functional, Matter features are in beta and may have limited compatibility with certain device types as the API matures.
Legacy Support: Support for Homebridge 1.3+ is included in the codebase but has not been extensively tested.
