https://github.com/chee/homebridge-bluetooth-tag
https://github.com/chee/homebridge-bluetooth-tag
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/chee/homebridge-bluetooth-tag
- Owner: chee
- Created: 2022-02-03T20:45:31.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-08-04T04:08:40.000Z (almost 4 years ago)
- Last Synced: 2026-03-30T05:38:29.965Z (3 months ago)
- Language: JavaScript
- Size: 7.81 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.markdown
Awesome Lists containing this project
README
# homebridge-bluetooth-tag
A Homebridge plugin for exposing Bluetooth Low Energy button tags as switches in HomeKit.
## Supported Devices
This plugin has been tested with "iTag" bluetooth trackers which can be found on eBay for about AU$10.
Any device which exposes alert (1802:2A06) and button (FFE0:FFE1) characteristics should work.
These are typically listed to be used with the "iTracing" mobile app.
## Example Homebridge Configuration
```json
"accessories": [
{
"accessory": "Bluetooth Tag",
"name": "Bedroom Light Switch",
"address": "01:23:45:67:89:ab"
}
]
```
The `address` is optional. If omitted, the first device found will be used.
It is however recommended to set the address to avoid inadvertent connection to the wrong device.
The easiest way to find the address is to start the plugin without an address and then check the logs.
You should see output like `connecting iTAG (01:23:45:67:89:ab)`.