Local iPhone Bluetooth presence and estimated rooms for Home Assistant. Install with HACS, enroll with Presence Pair, and keep presence data in your home.
Presence Bridge is a local Home Assistant integration for iPhone Bluetooth presence and estimated rooms. Presence Pair is the companion iPhone app used to enroll a phone through a temporary HA invitation, without manually copying identity keys. After enrollment, receivers resolve rotating private Bluetooth addresses locally and expose presence, room, RSSI and tracker entities.
The HA integration and Windows/Linux receivers are free and MIT-licensed. The separate iPhone app is proprietary and currently free during compatibility testing. It may become paid in the future. The current release needs no purchase or subscription. There is no developer cloud account.
Yes. Search for Presence Bridge in the default HACS catalog, install the latest full release, restart HA and add the integration under Settings > Devices & services. A custom repository and beta opt-in are not required. Open the HACS page.
No. Enrollment needs a compatible receiver with BLE central connections and peripheral advertising. Windows uses a separate receiver and MQTT; its configured user must remain signed in, although the screen can be locked. Linux/BlueZ enrollment is experimental and needs D-Bus permissions and read-only bond storage. Suitable Linux hosts can run it inside HA without MQTT.
HA OS, Green, restricted NAS and virtual machines generally need a separate receiver. Supported HA Bluetooth proxies may extend passive reception, but Presence Bridge does not implement first-time enrollment on ESPHome/Shelly/ Sonoff proxies. Choose a setup before installing anything.
No for the Bluetooth exchange itself. Opening HA on the phone or using the optional live-signal monitor needs network access to your HA. Remote receivers need the local MQTT broker; in-process Linux enrollment uses HA directly.
The app must stay open near the receiver during initial enrollment. Subsequent presence observations are passive and do not require a continuous app-to-server Bluetooth connection. Phone advertisements and reception vary: missing samples are not evidence that somebody left.
No. It estimates the room of the phone, not necessarily its owner. RSSI varies with walls, antenna position, body orientation and radio silence. It is not precise ranging, wall-aware triangulation or proof of absence. Never use these observations alone for locks, alarms or safety decisions.
The main workflow here is owner-controlled iPhone enrollment, followed by private-address resolution and HA entities. It is not a claim that other presence projects are obsolete or incompatible. If an existing setup works, keep it; start with the architecture, protocol and compatibility matrix to judge whether this adds value.
No. You can add the generated Bluetooth tracker in Settings > People alongside your existing GPS/Wi-Fi trackers. The integration reports that association but does not edit HA’s internal Person data. Missing BLE reception produces unknown, not a definitive away decision.
Presence Pair requires iOS 17+. Windows has been used in the author’s physical setup; the full hardware matrix is not certified. Linux remains experimental. The iPhone app does not implement Android or Apple Watch enrollment. See the evidence and limits.
Ask a question, report a bug or hardware result, or improve the MIT integration and its documentation. Report the actual adapter, OS and versions; do not post real QR invitations, identity keys, addresses, credentials or HA backups. Read privacy and security.