{"id":14110896,"url":"https://github.com/Koenkk/zigbee-herdsman-converters","last_synced_at":"2025-08-01T11:31:21.503Z","repository":{"id":37265249,"uuid":"134597023","full_name":"Koenkk/zigbee-herdsman-converters","owner":"Koenkk","description":"Collection of device converters to be used with zigbee-herdsman","archived":false,"fork":false,"pushed_at":"2024-10-29T21:07:41.000Z","size":30888,"stargazers_count":903,"open_issues_count":104,"forks_count":3012,"subscribers_count":38,"default_branch":"master","last_synced_at":"2024-10-29T21:17:18.331Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/Koenkk.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2018-05-23T16:25:00.000Z","updated_at":"2024-10-29T19:41:02.000Z","dependencies_parsed_at":"2023-11-24T21:20:53.858Z","dependency_job_id":"65534c6b-749a-4cf8-8915-e264afadf3eb","html_url":"https://github.com/Koenkk/zigbee-herdsman-converters","commit_stats":{"total_commits":11169,"total_committers":2591,"mean_commits":4.310690852952528,"dds":0.5752529322231176,"last_synced_commit":"5d0ca39277af13557d9fc7211162504dd2f461a2"},"previous_names":["koenkk/zigbee-shepherd-converters"],"tags_count":1834,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Koenkk%2Fzigbee-herdsman-converters","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Koenkk%2Fzigbee-herdsman-converters/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Koenkk%2Fzigbee-herdsman-converters/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Koenkk%2Fzigbee-herdsman-converters/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Koenkk","download_url":"https://codeload.github.com/Koenkk/zigbee-herdsman-converters/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227293311,"owners_count":17759621,"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":[],"created_at":"2024-08-14T10:03:02.762Z","updated_at":"2025-08-01T11:31:21.491Z","avatar_url":"https://github.com/Koenkk.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"[![NPM](https://nodei.co/npm/zigbee-herdsman-converters.png)](https://nodei.co/npm/zigbee-herdsman-converters/)\n\n# zigbee-herdsman-converters\n\nCollection of device converters to be used with zigbee-herdsman.\n\n## Contributing\n\nSee [Zigbee2MQTT how to support new devices](https://www.zigbee2mqtt.io/advanced/support-new-devices/01_support_new_devices.html).\n\n### Creating a pull request\n\n#### Github codespaces\n\nYou can use Github codespaces to create pull requests with a fully setup editor, right from your web browser:\n- https://docs.github.com/en/codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository\n- https://docs.github.com/en/codespaces/developing-in-a-codespace/using-github-codespaces-for-pull-requests\n\n#### Locally\n\nInstall the prerequisites:\n\n```sh\nnpm install -g pnpm\npnpm install --frozen-lockfile\n```\n\n#### Submitting your pull request\n\nBefore you submit a pull request, you should run the following commands to ensure your changes will pass the tests:\n\n```sh\npnpm run check --fix\npnpm run build\npnpm test\n```\n\nIf any of those commands finish with an error your PR won't pass the tests and will likely be rejected.\n\n## Breaking changes\n\n24.0.0\n\n- It's not longer possible to call `definition.exposes(undefined, undefined)`, use `definition.exposes({isDummyDevice: true}, {})` instead (#9601)\n\n23.0.0\n\n- A `Publish` now has to be passed to toZigbee converters (#8875)\n\n22.0.0\n\n- `addDefinition` has been renamed to `addExternalDefinition`\n- An import of `zigbee-herdsman-converters` does not expose all `definitions` anymore. Use this instead:\n```js\n(await import('zigbee-herdsman-converters/devices/index')).default.forEach((baseDefinition) =\u003e {\n    const d = zhc.prepareDefinition(baseDefinition);\n});\n```\n\n21.0.0\n\n- Various breaking changes, see [CHANGELOG.md](https://github.com/Koenkk/zigbee-herdsman-converters/blob/v21.0.0/CHANGELOG.md#-breaking-changes).\n\n20.0.0\n\n- A toZigbee converter is now allowed to not define any `key`, in this case the converter should be used for any key.\n\n19.0.0\n\n- Legacy extend was removed\n\n18.0.0\n\n- After converting a message with a fromZigbee converter, `postProcessConvertedFromZigbeeMessage` should be called now (for applying calibration/precision)\n\n17.0.0\n\n- Various methods in `index.ts` are now async and return a `Promise`\n\n15.0.0\n\n- OTA `isUpdateAvailable` now returns an object instead of a boolean (e.g. `{available: true, currentFileVersion: 120, otaFileVersion: 125}`)\n- OTA `updateToLatest` now returns a number (`fileVersion` of the new OTA) instead of a void\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FKoenkk%2Fzigbee-herdsman-converters","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FKoenkk%2Fzigbee-herdsman-converters","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FKoenkk%2Fzigbee-herdsman-converters/lists"}