BTHome
homebridge-bthome · v2.1.0
Adds BTHome Bluetooth sensors and buttons to HomeKit locally.
What it says it supports
Brands
- Shelly
Devices it names
- BTHome sensors
Shows up in Apple Home as from its README
Sensor readings in its code
What people report
Reads BTHome Bluetooth sensors such as Shelly BLU devices locally; door/window added in v2.
- Works2
| Device | Status | What they said | Source |
|---|---|---|---|
| Shelly BLU Door/Window sensor | Works | Added in v2.0.0; inverted contact state fixed in beta.1Saved copyIs your feature request related to a problem? Please describe: It would be Great to be able to run the BLU Door / Window Sensor with this Plugin as Well. Describe the solution you'd like: Add Support for BLU Door / Window Sensor for this Plugin Describe alternatives you've considered: Other Plugins, which Need cloud Connection / Access like homebridge-Shelly-blu Additional context: Excerpt saved from GitHub on 2026-10-22. | Issue #2 · 2025-06 |
| Shelly BLU H&T ZB | Works | Works once MAC typo correctedSaved copyHello! Shelly has issued some new version of the BLU H&T, it is called Shelly BLU H&T ZB: Device identification Device name: Shelly BLU H&T ZB Device model: SBHT-203C Device Bluetooth ID: 0x0011 https://kb.shelly.cloud/knowledge-base/shelly-blu-h-t-zb I configured one of this new device in the plugin but it keeps saying the following: ` [30.07.2026 14:20:57] [BTHomePlatform] [c0:2c:ed:xx:yy:zz] Device is advertising [30.07.2026 14:20:57] [BTHomePlatform] [c0:2c:ed:xx:yy:zz] Skipping not configured device [30.07.2026 14:20:57] [BTHomePlatform] [c0:2c:ed:xx:yy:zz] Device is advertising … Excerpt saved from GitHub on 2026-10-22. | Issue #11 · 2026-07 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local
Bluetooth LE from the Homebridge host
You’ll need
- Bluetooth adapter
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | ^1.8.0 || ^2.0.0-beta.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^20.18.0 || ^22.10.0 || ^24.0.0 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | BTHomePlatform |
| License | Apache-2.0 |
Community signals
| Downloads a week | 4 |
|---|---|
| Downloads a month | 37 |
| GitHub stars | 3 |
| Open issues | 1 |
| Closed issues | 8 |
| Last code push | 2026-09-03 |
| Latest version | 2.1.0 (2026-01-25) |
| First published | 2025-01-20 |
| Releases | 20 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- AirQualitySensor
- Battery
- CarbonDioxideSensor
- CarbonMonoxideSensor
- ContactSensor
- HumiditySensor
- LightSensor
- MotionSensor
- OccupancySensor
- SmokeSensor
- StatelessProgrammableSwitch
- TemperatureSensor
Sources
- npm: https://www.npmjs.com/package/homebridge-bthome
- Source code: https://github.com/byonchev/homebridge-bthome
- Issues: https://github.com/byonchev/homebridge-bthome/issues
- Verified plugins list: https://github.com/homebridge/verified



