Skip to content
This repository has been archived by the owner on Sep 9, 2023. It is now read-only.

Manage people presence based on Bluetooth devices (phones, watches, tables, bluetooth keychain tags)

Notifications You must be signed in to change notification settings

paolotremadio/homebridge-automation-bluetooth-presence

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Automation - Bluetooth presence

Example config.json:

{
  "accessories": [
    {
      "accessory": "AutomationBluetoothPresence",
      "name": "Dad's iTag",
      "deviceId": "65504c9b6e5441f8927bbd768e455d4f",
      "gracePeriod": 600
    }
  ]
}

This accessory will create a motion sensor linked with a Bluetooth device.

When the device is found, the motion sensor is triggered. When the device is not seen for longer than gracePeriod, the motion sensor will stop detecting movement.

The plugin will show the history history in the Elgato's Eve app.

Installation

Before installing this library, make sure you have met all the system dependencies. See the Noble documentation. This plugin won't work unless all the system dependencies have been met.

Configuration options

Attribute Required Usage Example
name Yes A unique name for the accessory. It will be used as the accessory name in HomeKit. Dad's iTag
deviceId Yes The device ID. 65504c9b6e5441f8927bbd768e455d4f
gracePeriod No (default: 600) The number of seconds to wait for announcements before considering the device gone. 10 minutes (600 seconds) is recommended. 600 (seconds, equal to 10 mintues)

Find the device ID

Method 1 - Clone the repo

  1. Clone this repo
  2. Run npm install or yarn install in the folder you've cloned the repo
  3. Run npm run detect-devices. A list of devices will appear on screen. Grab the device ID from the list and add it to the config.

Method 2 - Install the plugin globally

  1. Run npm install homebridge-automation-bluetooth-presence -g
  2. Run automation-bt-detect-devices. A list of devices will appear on screen. Grab the device ID from the list and add it to the config.

Devices that can be monitored

You can track:

  • Phones
  • Tables
  • (some) Computers
  • Smart watches
  • Headphones / Earphones
  • Fitness trackers
  • Cheap key fobs like the "iTag" devices or Tile trackers

About

Manage people presence based on Bluetooth devices (phones, watches, tables, bluetooth keychain tags)

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published