{"id":24525617,"url":"https://github.com/byonchev/homebridge-bthome","last_synced_at":"2026-01-25T15:03:48.928Z","repository":{"id":273423234,"uuid":"915630016","full_name":"byonchev/homebridge-bthome","owner":"byonchev","description":"A Homebridge plugin that integrates Bluetooth devices communicating via the BTHome protocol into Apple HomeKit.","archived":false,"fork":false,"pushed_at":"2025-08-30T12:23:59.000Z","size":381,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"latest","last_synced_at":"2025-09-27T09:25:38.039Z","etag":null,"topics":["ble","blu","bthome","homebridge","shelly","shelly-blu"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/byonchev.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-01-12T11:43:12.000Z","updated_at":"2025-08-30T12:24:02.000Z","dependencies_parsed_at":null,"dependency_job_id":"40dabebb-7e35-417f-a224-0ea1828b1ad5","html_url":"https://github.com/byonchev/homebridge-bthome","commit_stats":null,"previous_names":["byonchev/homebridge-bthome"],"tags_count":18,"template":false,"template_full_name":"homebridge/homebridge-plugin-template","purl":"pkg:github/byonchev/homebridge-bthome","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byonchev%2Fhomebridge-bthome","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byonchev%2Fhomebridge-bthome/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byonchev%2Fhomebridge-bthome/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byonchev%2Fhomebridge-bthome/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/byonchev","download_url":"https://codeload.github.com/byonchev/homebridge-bthome/tar.gz/refs/heads/latest","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byonchev%2Fhomebridge-bthome/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28754807,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T13:59:49.818Z","status":"ssl_error","status_checked_at":"2026-01-25T13:59:33.728Z","response_time":113,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["ble","blu","bthome","homebridge","shelly","shelly-blu"],"created_at":"2025-01-22T05:19:25.821Z","updated_at":"2026-01-25T15:03:48.915Z","avatar_url":"https://github.com/byonchev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg width=\"410px\" src=\"https://github.com/user-attachments/assets/999cf798-d454-4df7-998f-af1d9850f0fd\"\u003e\n\u003c/p\u003e\n\n# homebridge-bthome\n\nHomebridge plugin for integrating BTHome devices into HomeKit\n\n[![npm](https://img.shields.io/npm/v/homebridge-bthome/latest?label=latest)](https://www.npmjs.com/package/homebridge-bthome) [![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)\n\n### Overview\n\n`homebridge-bthome` enables seamless integration of Bluetooth devices that communicate using the [BTHome](https://bthome.io/) data format into your HomeKit setup.\n\nIt works locally — no gateways or cloud services are required. The plugin connects directly to supported devices.\n\n### Prerequisites\n\nTo utilize this plugin, ensure that:\n\n- Your Homebridge setup includes Bluetooth hardware.\n- The necessary drivers for your Bluetooth hardware are installed and functioning correctly.\n\n### Configuration\n\nThis plugin does not automatically add all discovered BTHome devices. Each device must be manually configured.\n\n#### Required Fields:\n\n- **Device MAC Address:** The unique MAC address of the device must be specified.\n- **Encryption Key (if applicable):** If the device payload is encrypted, you must provide the encryption key. Note that the plugin does not share or store this key outside the configuration file.\n\n### Supported Sensor Types\n\n- Air Quality (PM2.5, PM10 and VOC)\n- Battery Level\n- Push Button\n- Carbon Dioxide Levels\n- Carbon Monoxide Detection\n- Contact Detection\n- Relative Humidity\n- Illuminance\n- Motion Detection\n- Occupancy Detection\n- Smoke Detection\n- Temperature\n\n### Supported Devices\n\n| Device                 | Support status       | Tested             |\n| ---------------------- | ------------------   | ------------------ |\n| Shelly BLU H\u0026T         | :heavy_check_mark:   | :heavy_check_mark: |\n| Shelly BLU Motion      | :heavy_check_mark:   | :heavy_check_mark: |\n| Shelly BLU Door/Window | :heavy_check_mark:   | :heavy_check_mark: |\n| Shelly BLU Button      | :heavy_check_mark:   | :x:                |\n| Shelly BLU Wall Switch | :heavy_check_mark:   | :x:                |\n| Shelly BLU RC Button   | :heavy_check_mark:   | :x:                |\n| Shelly BLU TRV         | _Partial support\\*_  | :x:                |\n\n\n_If you own some of the untested devices and the plugin works for you, please let me know so I can update its status._\n\n#### Notes:\n\n- _\\* Partial support:_ The BTHome protocol is one-way (read-only), which means Homebridge can only receive data from these devices. If a device requires additional features that depend on sending data back (e.g., configuration changes, control commands, switching modes), those functions will not be available while using this plugin.\n\n\u003ca id=\"supported_features\"\u003e\u003c/a\u003e\n\n### Supported Features\n\n| Feature                               | Support Status     |\n| ------------------------------------- | ------------------ |\n| Encryption                            | :heavy_check_mark: |\n| Multiple Sensor Readings of Same Type | :heavy_check_mark: |\n| Multiple Bluetooth Devices\\*          | :x:                |\n| EVE Services \u0026 Characteristics        | Planned            |\n| Fakegato                              | Planned            |\n\n#### Notes:\n\n- _\\* Multiple Bluetooth Devices:_ If your setup includes multiple Bluetooth devices, the plugin will default to using the first available device.\n\n### Contributing\n\nWe welcome contributions! If you would like to contribute, please create an issue first, detailing the feature or functionality you intend to implement and the device you are working with.\n\nPull requests are encouraged and appreciated!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbyonchev%2Fhomebridge-bthome","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbyonchev%2Fhomebridge-bthome","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbyonchev%2Fhomebridge-bthome/lists"}