{"id":15018233,"url":"https://github.com/snowdd1/homebridge-knx","last_synced_at":"2025-04-09T10:06:15.836Z","repository":{"id":46804609,"uuid":"42263889","full_name":"snowdd1/homebridge-knx","owner":"snowdd1","description":"KNX platform shim for homebridge","archived":false,"fork":false,"pushed_at":"2023-04-12T22:03:47.000Z","size":1191,"stargazers_count":97,"open_issues_count":42,"forks_count":56,"subscribers_count":28,"default_branch":"master","last_synced_at":"2025-04-02T09:07:16.199Z","etag":null,"topics":["homebridge","homebridge-knx","homebridge-plugin","knx","knxd"],"latest_commit_sha":null,"homepage":"https://github.com/nfarina/homebridge","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/snowdd1.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":"2015-09-10T18:49:03.000Z","updated_at":"2025-02-24T09:38:59.000Z","dependencies_parsed_at":"2024-06-21T15:34:36.793Z","dependency_job_id":"221bc748-8b30-4936-a445-27357f32ad45","html_url":"https://github.com/snowdd1/homebridge-knx","commit_stats":{"total_commits":297,"total_committers":25,"mean_commits":11.88,"dds":0.4175084175084175,"last_synced_commit":"687fd186e81c1bc5a563b25e728beab40c7b4393"},"previous_names":[],"tags_count":40,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snowdd1%2Fhomebridge-knx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snowdd1%2Fhomebridge-knx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snowdd1%2Fhomebridge-knx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snowdd1%2Fhomebridge-knx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/snowdd1","download_url":"https://codeload.github.com/snowdd1/homebridge-knx/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248008628,"owners_count":21032556,"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-knx","homebridge-plugin","knx","knxd"],"created_at":"2024-09-24T19:51:42.699Z","updated_at":"2025-04-09T10:06:15.810Z","avatar_url":"https://github.com/snowdd1.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# homebridge-knx Version 0.4 \n[![NPM version][npm-image]][npm-url] [![Downloads][downloads-image]][npm-url][![Dependency status][david-dm-image]][david-dm-url]   \n\nKNX platform shim for homebridge.\n**This cannot run stand-alone in node!**\n\nPlease also visit [homebridge github homepage](https://github.com/nfarina/homebridge) first.\n\nLatest to homebridge-knx changes can be found in the [CHANGELOG.md](CHANGELOG.md)\n\n### This can only be used with homebridge \u003e=1.0 and Node \u003e=10.19.0\n\n### Prerequisites\nThis node module requires either \n  - a running (and properly configured) **knx daemon (knxd)**. You can find the latest version [here](https://github.com/knxd/knxd).  \n  - another KNX router which can be reached by KNX multicasts.\n\nI cannot support the knxd. Please address issues directly at the [knxd issue pages](https://github.com/knxd/knxd/issues). It might help to search the existing issues, as your problem might have been solved already.  \n\n### Installation and running\n- Install homebridge first, from [https://homebridge.io/](https://homebridge.io/); \n- Once you have your instance running (without any devices yet), go to the `Plugins` tab and type `knx` in the search box\n- `homebridge-knx` should be within the top five hits (yes, there are alternatives), please check the name before installing\n- Then put the configuration file *knx_config.json* into `~/.homebridge` (or another folder to your liking, but it should be reaadable and writable by user `homebridge` or group `homebridge` which is created by the homebridge installer), and adapt them to your needs (knxd address and some test devices in `knx_config.json`)\n-  Eliminate everything (especially all group addresses) that might harm your KNX installation. Sending bus telegrams to your alarm device might wake the neighbourhood unpleasantly!\n- If you used the dfeault paths (~/.homebridge/knx_config.json) you can just restart homebridge using the GUI\n- If you didn't, or want to use child bridges for more accessories (than 149) you need to configure homebridge (using the GUI e.g.). The following sample is from my test installation\n\n```json\n{\n    \"bridge\": {\n        \"name\": \"Homebridge 17AF\",\n        \"username\": \"0E:0B:9B:24:17:AD\",\n        \"port\": 51485,\n        \"pin\": \"880-83-869\",\n        \"advertiser\": \"avahi\"\n    },\n    \"accessories\": [],\n    \"platforms\": [\n        {\n            \"name\": \"Config\",\n            \"port\": 8581,\n            \"auth\": \"form\",\n            \"theme\": \"auto\",\n            \"tempUnits\": \"c\",\n            \"lang\": \"en\",\n            \"platform\": \"config\"\n        },\n        {\n            \"name\": \"KNX\",\n            \"platform\": \"KNX\",\n            \"config_path\": \"/home/pi/homebridge/dg-knx_config.json\"\n        },\n        {\n            \"name\": \"KNX\",\n            \"platform\": \"KNX\",\n            \"config_path\": \"/home/pi/homebridge/og-knx_config.json\",\n            \"_bridge\": {\n                \"username\": \"0E:0B:9B:24:17:00\",\n                \"port\": 51490\n            }\n        }\n    ]\n}\n```\n\n\n# Assumptions\nWithout using a special handler (add-in) for the service, homebridge-knx assumes the following:\n\nHomeKit type | KNX addresses DPT   \n-------- | ------  \nBoolean | DPT1  \nInteger | DPT5  \nPercentage | DPT5.001  \nFloat | DPT9  \n\n\n# knx_config.json\nSee the [complete Doc!](https://github.com/snowdd1/homebridge-knx/blob/master/knx_config.json.md).\n\n\n# Add-ins\nAdd-in (aka \"handlers\") can change the default behavior. [See the article](https://github.com/snowdd1/homebridge-knx/blob/master/handler-add-in.md)\n\nHappy testing!\n\n\n[npm-url]: https://npmjs.org/package/homebridge-knx\n[downloads-image]: http://img.shields.io/npm/dm/homebridge-knx.svg\n[npm-image]: http://img.shields.io/npm/v/homebridge-knx.svg\n[david-dm-url]: https://david-dm.org/snowdd1/homebridge-knx\n[david-dm-image]: https://david-dm.org/snowdd1/homebridge-knx.svg\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsnowdd1%2Fhomebridge-knx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsnowdd1%2Fhomebridge-knx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsnowdd1%2Fhomebridge-knx/lists"}