Skip to content
Homebridge TestFlight
Shelly

BTHome

homebridge-bthome · v2.1.0

VerifiedLocalHomebridge 2.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
DeviceStatusWhat they saidSource
Shelly BLU Door/Window sensorWorksAdded in v2.0.0; inverted contact state fixed in beta.1
Saved copy
Is 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 ZBWorksWorks once MAC typo corrected
Saved copy
Hello! 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 HomebridgeYes
Homebridge versions^1.8.0 || ^2.0.0-beta.0
Homebridge 2.0Yes
Node.js^20.18.0 || ^22.10.0 || ^24.0.0
Settings in Homebridge UIYes
MatterNo
Platform nameBTHomePlatform
LicenseApache-2.0

Community signals

Downloads a week4
Downloads a month37
GitHub stars3
Open issues1
Closed issues8
Last code push2026-09-03
Latest version2.1.0 (2026-01-25)
First published2025-01-20
Releases20

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