homebridge-wireless-sensor-tags

Homebridge platform plugin for Wireless Sensor Tags.

This is an update of the discontinued rodtoll/homebridge-wireless-sensor-tag plugin for current Homebridge (1.8+ and 2.x) and Node.js (20, 22, or 24). The original npm name is still taken, so this plugin is published as homebridge-wireless-sensor-tags.

Each tag is exposed as a HomeKit accessory with:

• Temperature
• Humidity (when the tag reports it)
• Occupancy (detected while the tag is alive and in range)
• Battery level

Occupancy is not detected when a tag is inactive or out of range, matching the original plugin.

Requirements

• Homebridge 1.8.0 or 2.x
• Node.js 20, 22, or 24

Installation

Install from the Homebridge UI by searching for Wireless Sensor Tag, or:

npm install -g homebridge-wireless-sensor-tags

For local development:

npm install
npm run build
npm link

Then restart Homebridge.

Configuration

Add the platform in the Homebridge UI, or to config.json:

{
  "platforms": [
    {
      "platform": "wireless-sensor-tag",
      "name": "Wireless Sensor Tag",
      "token": "your-oauth2-access-token",
      "queryFrequency": 20000,
      "ignoreList": ["Honda"]
    }
  ]
}

Email/password login from the original plugin still works if you do not have a token:

{
  "platforms": [
    {
      "platform": "wireless-sensor-tag",
      "name": "Wireless Sensor Tag",
      "username": "[email protected]",
      "password": "password",
      "queryFrequency": 20000,
      "ignoreList": ["Honda"]
    }
  ]
}

| Field | Required | Description | | --- | --- | --- | | platform | yes | Must be wireless-sensor-tag | | name | yes | Display name for this platform instance | | token | recommended | OAuth2 access token from My OAuth2 Apps | | username | if no token | Your mytaglist.com / wirelesstag.net email | | password | if no token | Your mytaglist.com / wirelesstag.net password | | queryFrequency | no | Poll interval in milliseconds. Minimum 5000, default 20000 | | ignoreList | no | Exact tag names to skip. Matching is case-sensitive |

If both a token and username/password are set, the token is used.

Creating an OAuth2 token

1. Open https://www.mytaglist.com/eth/oauth2_apps.html
2. Register an app and authorize it against your account
3. Exchange the returned code for an access token
4. Paste that token into the plugin config

Upgrading from 0.0.x

This rewrite uses the Homebridge dynamic platform API, TypeScript, native fetch, and HTTPS. Cached accessories from the old static platform may not map 1:1. After upgrading, if Home shows duplicate or stale tags, remove the old accessories (or reset this plugin's cached accessories) and restart Homebridge.

Development

npm install
npm run lint
npm run build

npm run watch compiles on change and launches Homebridge with ./test/hbConfig.