Homebridge plugin for integrating BTHome devices into HomeKit
The homebridge-bthome plugin enables seamless integration of Bluetooth devices using the BTHome data format into your HomeKit ecosystem.
Please note that the plugin is in its early development stage and currently supports a limited range of sensor types.
Refer to the Supported Features section for detailed information.
To utilize this plugin, ensure that:
- Your Homebridge setup includes Bluetooth hardware.
- The necessary drivers for your Bluetooth hardware are installed and functioning correctly.
This plugin does not automatically add all discovered BTHome devices. Each device must be manually configured.
- Device MAC Address: The unique MAC address of the device must be specified.
- 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.
- Temperature
- Relative Humidity
- Battery Level
- Push Button
- Illuminance
- Motion detection
This is a list of devices that should work with this plugin. Some of them aren't tested (see table below).
If you own some of the untested devices and the plugin works for you, please let me know so I can update its status.
| Device | Tested |
|---|---|
| Shelly BLU H&T | ✔️ |
| Shelly BLU Button | ❌ |
| Shelly BLU Wall Switch | ❌ |
| Shelly BLU RC Button | ❌ |
| Shelly BLU Motion | ❌ |
| Feature | Support Status |
|---|---|
| Encryption | ✔️ |
| Occasional Sensor Data* | ✔️ |
| Multiple Bluetooth Devices** | ❌ |
| Multiple Sensor Readings of Same Type | ❌ |
- *Occasional Sensor Data: This refers to data not consistently present in the device payload. For instance, the Shelly BLU H&T device only reports its push button state when the button is pressed; this data is absent in periodic updates.
- **Multiple Bluetooth Devices: If your setup includes multiple Bluetooth devices, the plugin will default to using the first available device.
We 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.
Pull requests are encouraged and appreciated!