{"id":13582914,"url":"https://github.com/tuya/tuya-homebridge","last_synced_at":"2025-05-16T07:05:35.771Z","repository":{"id":37651535,"uuid":"358538771","full_name":"tuya/tuya-homebridge","owner":"tuya","description":"Homebridge custom plugin for controlling Powered by Tuya (PBT) devices in HomeKit. This plugin is officially maintained by the Tuya Developer Team.","archived":false,"fork":false,"pushed_at":"2024-07-21T03:22:14.000Z","size":158,"stargazers_count":374,"open_issues_count":21,"forks_count":193,"subscribers_count":28,"default_branch":"master","last_synced_at":"2025-05-15T03:35:25.215Z","etag":null,"topics":["homebridge","homebridge-plugin","homekit","iot","mqtt","openapi","tuya"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tuya.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-16T09:01:50.000Z","updated_at":"2025-05-08T06:06:26.000Z","dependencies_parsed_at":"2023-12-28T07:40:32.810Z","dependency_job_id":"ddbc28fd-499f-433b-b52a-1062a030b431","html_url":"https://github.com/tuya/tuya-homebridge","commit_stats":{"total_commits":112,"total_committers":13,"mean_commits":8.615384615384615,"dds":0.5089285714285714,"last_synced_commit":"175af8a12befcb120e5d6fb55d9842642211c334"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuya%2Ftuya-homebridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuya%2Ftuya-homebridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuya%2Ftuya-homebridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuya%2Ftuya-homebridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tuya","download_url":"https://codeload.github.com/tuya/tuya-homebridge/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254485060,"owners_count":22078767,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["homebridge","homebridge-plugin","homekit","iot","mqtt","openapi","tuya"],"created_at":"2024-08-01T15:03:07.438Z","updated_at":"2025-05-16T07:05:30.723Z","avatar_url":"https://github.com/tuya.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"Tuya Homebridge Plugin\n========================\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://images.tuyacn.com/app/hass/hb_tuya.png\" width=\"70%\"\u003e\u003cbr\u003e\n\u003c/p\u003e\n\n\u003cspan align=\"center\"\u003e\n    \n[![npm](https://img.shields.io/npm/v/homebridge-tuya-platform.svg)](https://www.npmjs.com/package/homebridge-tuya-platform)\n[![npm](https://img.shields.io/npm/dt/homebridge-tuya-platform.svg)](https://www.npmjs.com/package/homebridge-tuya-platform)\n[![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)\n    \n[![GitHub watchers](https://img.shields.io/github/watchers/tuya/tuya-homebridge.svg?style=social\u0026label=Watch)](https://GitHub.com/tuya/tuya-homebridge/watchers/)\n[![GitHub stars](https://img.shields.io/github/stars/tuya/tuya-homebridge.svg?style=social\u0026label=Star)](https://GitHub.com/tuya/tuya-homebridge/stargazers/)\n[![GitHub forks](https://img.shields.io/github/forks/tuya/tuya-homebridge.svg?style=social\u0026label=Fork)](https://GitHub.com/tuya/tuya-homebridge/network/)\n\nIf you like Tuya Homebridge Plugin - give it a star, or fork it and contribute!\n\n\u003c/span\u003e\n\nHomebridge custom plugin for controlling Powered by Tuya (PBT) devices in HomeKit, it's based on [Tuya Open API](https://developer.tuya.com/en/docs/cloud/?_source=2e646f88eae60b7eb595e94fc3866975). The plugin is officially maintained by the Tuya Developer Team.\n\n✌️✌️✌️ [Supported Tuya Device Types](https://github.com/tuya/tuya-homebridge/wiki/Supported-Tuya-Device-Types?_source=6a1b8046224626e798190c06532c8be2) ✌️✌️✌️\n\n :tada: :tada: :tada: [Vote for Tuya Homebridge Plugin New Device Driver Support!](https://github.com/tuya/tuya-homebridge/discussions/58) :tada::tada::tada:\n\n## [Tuya Beta Test Program](https://pages.tuya.com/develop/Homebridgebetainvitation?_source=ea61b9486f59eb89a3ee74b43140b9f3#form)\nWelcome to join the [Tuya Beta Test Program](https://pages.tuya.com/develop/Homebridgebetainvitation?_source=ea61b9486f59eb89a3ee74b43140b9f3#form) to get your development gifts and make the contribution to the plugin.Your feedback is valuable to the whole community.\n\n## Important Note\n\nIf you cannot login successfully, please update to v1.5.0 as the previous version has security issues on the login feature of the plugin.\n\n### Youtube Tutorial:\n\n[![Youtube](https://img.youtube.com/vi/YH6d-2VJMaU/0.jpg)](https://www.youtube.com/watch?v=YH6d-2VJMaU)\n\n## Preparation\n  1. [Tuya IoT Platform Configuration](https://github.com/tuya/tuya-homebridge/wiki/Tuya-IoT-Platform-Configuration-Guide-Using-Smart-Home-PaaS?_source=d8fba44feeef4757f7f22a14c2295f3f)\n  2. [Use the Tuya Homebridge Plugin](https://github.com/tuya/tuya-homebridge/wiki/How-to-Use-Tuya-Homebridge-Plugin?_source=6a2b624bdb6dce83dd246e014ccd0bcf)\n  3. [Develop a New Driver](https://github.com/tuya/tuya-homebridge/wiki/How-to-Develop-a-New-Driver?_source=44108482f4dfcf47095e53dcf7dbba95)\n  4. [How to Get Logs](https://github.com/tuya/tuya-homebridge/wiki/How-To-Get-Logs)\n\n## Set up the development environment\n\n```\n—-VSCode\n—-engines\n    \"node\": “\u003e=0.12.0”\n    \"homebridge\": \"\u003e=0.2.0\"\n—-dependencies\n    \"axios\": “^0.21.1\",\n    \"crypto-js\": “^4.0.0”, \n    \"mqtt\": “^4.2.6\",\n    \"uuid\": \"^8.3.2\"\n```\n\n## Tuya OpenApi Login Error Code\n\n| Error code | Error message | Troubleshooting |\n|:----|:----|:----|\n| 1004 | sign invalid | \u003cul\u003e\u003cli\u003e Incorrect `accessId` or `accessKey`. To fix the error, see [Edit config.json](https://developer.tuya.com/en/docs/iot/Tuya_Homebridge_Plugin?id=Kamcldj76lhzt#config) file.\u003c/li\u003e\u003cli\u003e Due to the new signature verification mode, the server will have the cache of the old mode. Please create a Github Issue to inform us. |\n| 1106 | permission deny | \u003cul\u003e\u003cli\u003e Your app account is not linked with your cloud project: Link devices by using the Tuya Smart or Smart Life app with your cloud project on the [Tuya IoT Platform](https://iot.tuya.com/cloud/). For more information, see [Link devices by app account](https://developer.tuya.com/en/docs/iot/Platform_Configuration_smarthome?id=Kamcgamwoevrx#title-3-Link%20devices%20by%20app%20account).\u003c/li\u003e\u003cli\u003eThe **TuyaSmart** or **SmartLife** app account which registered using **Google** or **Apple ID** email need to link your phone number and use the linked phone number as **username** to login. \u003c/li\u003e\u003cli\u003e Incorrect username or password: Enter the correct account and password of the Tuya Smart or Smart Life app in the **Account** and **Password** fields. Note that the app account must be the one you used to link devices with your cloud project on the [Tuya IoT Platform](https://iot.tuya.com/cloud/).\u003c/li\u003e\u003cli\u003eIncorrect endpoint: See [Endpoint](https://developer.tuya.com/en/docs/iot/Tuya_Homebridge_Plugin?id=Kamcldj76lhzt#endpoint) and enter the correct endpoint.\u003c/li\u003e\u003cli\u003eIncorrect countryCode: Enter the [code of the country](https://countrycode.org/) you select on logging in to the Tuya Smart or Smart Life app.\u003c/li\u003e\u003cli\u003eIncorrect **schema** (case insensitive). Currently only **tuyaSmart** and **smartlife** are supported.\u003c/li\u003e\u003c/ul\u003e |\n| 1100 | param is empty | `username` or `appSchema` is empty: See [Edit config.json](https://developer.tuya.com/en/docs/iot/Tuya_Homebridge_Plugin?id=Kamcldj76lhzt#config) file and enter the correct parameter. |\n| 2017 | schema does not exist | Incorrect `appSchema` in `config.json`: See [Edit config.json](https://developer.tuya.com/en/docs/iot/Tuya_Homebridge_Plugin?id=Kamcldj76lhzt#config) file and enter the correct parameter. |\n| 2406 | skill id invalid | \u003cul\u003e\u003cli\u003eMake sure you use the Tuya Smart or SmartLife app account to log in. Also, choose the right data center endpoint related to your country region. For more details, please check [Countries/Regions and Data Center](https://github.com/tuya/tuya-home-assistant/blob/master/docs/regions_dataCenters.md).\u003c/li\u003e\u003cli\u003eYour cloud project on the [Tuya IoT Development Platform](https://iot.tuya.com/?_source=a4c65f56395e05cf64cc8d4abb7396b6) should be created after May 25, 2021. Otherwise, you need to create a new project. \u003c/li\u003e\u003c/ul\u003e |\n| 28841105 | No permissions. This project is not authorized to call this API | You have not authorized your cloud project to use the required APIs. Subscribe to the following required [API products](https://developer.tuya.com/en/docs/iot/applying-for-api-group-permissions?id=Ka6vf012u6q76#title-2-Subscribe%20to%20cloud%20products) and [authorize your project to use them](https://developer.tuya.com/en/docs/iot/applying-for-api-group-permissions?id=Ka6vf012u6q76#title-3-Authorize%20projects%20to%20call%20the%20cloud%20product).   \u003cul\u003e\u003cli\u003eAuthorization\u003c/li\u003e\u003cli\u003eSmart Home Devices Management\u003c/li\u003e\u003cli\u003eSmart Home Family Management\u003c/li\u003e\u003cli\u003eSmart Home Scene Linkage\u003c/li\u003e\u003cli\u003eSmart Home Data Service\u003c/li\u003e\u003cli\u003eDevice Status Notification\u003c/li\u003e\u003c/ul\u003e |\n\n## Users\n\nIf you are a smart home geek and have a bundle of devices from different platforms, this step-by-step tutorial will help you make devices HomeKit-enabled and then develop Tuya Homebridge plugins.\n\n## Feedback\n\nYou can use the **GitHub Issue** or [**tickets**](https://service.console.tuya.com/8/2/list?_source=c5965e0f53c87ba9d0eb99af0f4b124f) to provide feedback on any problems you encounter.\n\n## Beta version\nTuya plugin for Hombridge, maintained by @0x5e, former employee of Tuya.\n- https://github.com/0x5e/homebridge-tuya-platform/releases\n\n## LICENSE\n\nFor more information, see the [LICENSE](LICENSE) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftuya%2Ftuya-homebridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftuya%2Ftuya-homebridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftuya%2Ftuya-homebridge/lists"}