homebridge-betterkey: turn "car parked at home" into a HomeKit motion trigger
Disclosure up front: I make BetterKey, the iOS app this bridges from.
I wanted to bring the passive automations from BetterKey into my smart home. I found that Home Arrival was something I would actually use and allowed the app to have a deeper integration for connected car/home automation enthusiasts. Sharing in case it's useful to others who would also be interested in BetterKey.
What it does:
- One motion sensor per vehicle, named
{Vehicle} Parked at Home. - Each time BetterKey confirms the car parked inside a home area you drew on the map, the sensor flips to "motion detected" for about 30 seconds and then back to "no motion." That's enough for Apple Home to run an automation like "when Forester Parked at Home detects motion after sunset, turn on the driveway lights."
- Dynamic platform, so vehicles are added and removed automatically as they show up in BetterKey.
- Polls the BetterKey API on a configurable interval (default 60s, range 30 to 600s). Confirmed arrivals persist server side for 24h, so a Homebridge restart during that window will still catch the event.
- Verbose logging option that records event ids and dispatch outcomes. The API key is never logged.
A few things worth calling out up front:
- Requires an active BetterKey subscription and the iOS BetterKey app with Home Arrival turned on (feature overview at https://betterkey.xyz/home-arrival). If you are not already a BetterKey user, this plugin will not be useful on its own.
- Arrival only. It never reports "away" or "not parked," and if iOS suspends BetterKey in the background a specific park can be missed. A missed trigger is inconvenient rather than unsafe, since nothing downstream is treating the sensor as authoritative presence.
- The comparison between "where the car is" and "the home area you drew" happens entirely on the iPhone. Only a short-lived arrival event (id, vehicle, timestamp) leaves the device for this plugin to poll. No coordinates, no radius, no vehicle location.
Install from the Homebridge UI by searching for BetterKey, or from the CLI:
npm install -g homebridge-betterkey
Repo, config, and troubleshooting: https://github.com/CMLabsLLC/homebridge-betterkey
Happy to answer questions or take device reports in the thread.