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 designed to keep presence inference inside the home.
person entity;The IRK is stored in Home Assistant’s private .storage area. It is never
returned by the panel, entities, services, or diagnostics.
Observation snapshots remain on the configured local MQTT broker. Logs contain errors and counters, not IRKs or pairing secrets.
The app does not create an account, collect analytics, access contacts, request location permission, or send data to a developer-operated server. Camera frames are not stored. Pairing invitations are discarded when they expire or complete.
Scanning a separate signal QR enables foreground HTTPS polling of the user’s own HA server. The payload contains only the selected phone’s label, receiver names, areas, RSSI and sample timestamps. This does not open a Bluetooth connection or upload data to the developer. Signal QR credentials are single use; the resulting grant expires in 90 days. HA stores credential hashes only. It can revoke this access without removing the Bluetooth bond. The app can remove its local credential; it is not synchronized through iCloud or backups. Do not share signal QR codes. The app does not include signal credentials or receiver labels in optional support diagnostics.
The iPhone app’s Report a problem action lets you describe an issue and preview an optional technical summary. It includes the iPhone hardware model, iOS/app versions, RSSI and up to 60 pairing steps with relative times and allowlisted error codes. It excludes pairing QR contents, secrets, IRKs, Bluetooth/network addresses, person names and receiver names. Raw Bluetooth error messages are not exported.
Nothing is sent automatically. You may omit diagnostics, cancel, or send the
report through your chosen email/share app. A message sent to
rikyravi@gmail.com is received for support, together with its sender address,
sender name and whatever text you choose to include. Review these before
sending, and never attach QR codes, keys, credentials or full HA backups.
These reports are used to investigate compatibility problems, not for tracking
or advertising. You can request deletion of your support correspondence at
the same address. Your chosen email/share provider has its own privacy policy.
Removal commands contain a one-way identity fingerprint, not the private key. An unfinished removal keeps a local Windows journal of only the exact device IDs, Bluetooth addresses and physical container needed to retry safely. That entry is deleted when removal is verified. HA retains the identity until the owning receiver confirms that the bonds and private key are absent. This does not erase the iPhone’s own saved-device list.
Security reports should be submitted privately through GitHub Security Advisories for this repository. Do not include real IRKs, broker credentials, or Home Assistant backups in a public issue.