Presence Bridge

Logo

Local iPhone Bluetooth presence and estimated rooms for Home Assistant. Install with HACS, enroll with Presence Pair, and keep presence data in your home.

View the Project on GitHub ravhello/presence-bridge

Privacy and security

Presence Bridge is designed to keep presence inference inside the home.

Data handled by the Home Assistant integration

The IRK is stored in Home Assistant’s private .storage area. It is never returned by the panel, entities, services, or diagnostics.

Data handled by the Windows observer

Observation snapshots remain on the configured local MQTT broker. Logs contain errors and counters, not IRKs or pairing secrets.

Data handled by Presence Pair

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.

Optional live signal

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.

Optional support reports

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.

Disclosure

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.