Repository navigation
Releases
0.2.4 - Supported HTTP API and Owner-Managed People
Supported HTTP API and Owner-Managed People
Presence Bridge is now in the default HACS catalog: search its name and install
the latest full release, without a custom repository or beta opt-in.
Presence Pair remains free during testing on the App Store, iOS 17+, version
1.0.0 (build 220). No new iPhone binary is needed.
Changes
- Read the public certificate path from
hass.http.ssl_certificate, never
.storage/httpor private TLS keys. Missing/invalid certificate paths do not
disable normal iOS TLS validation. - Stop changing HA's internal Person collection. Assign a new BLE tracker in
Settings > People, adding it alongside existing GPS/Wi-Fi trackers.
Existing assignments are preserved; YAML-managed people are managed in YAML. - Report current assignment status from public states and the actual tracker ID
from the entity registry. Flag other-owner conflicts, ignore cached success
flags and keep tracker IDs out of anonymized diagnostics. - Update English/Italian onboarding, compatibility and final physical tests.
Upgrade
Back up HA and receiver configuration, update the integration through HACS and
restart HA outside an active pairing. Refresh the panel afterwards. Do not
delete working phone bonds or reset the adapter. Public 0.2.3 receivers use the
same BLE protocol and do not require reinstalling for these improvements; new
0.2.4 receiver packages align version metadata only. Verify SHA256SUMS.txt.
The HA ZIP is flat: extract directly into custom_components/presence_bridge.
Validation Boundary
Software tests cover certificate pins, real HA public state and permission
boundaries, preservation of Person data, diagnostics redaction and frontend
guidance. Windows/Linux CI, HACS and hassfest must pass on the release commit.
The final iPhone test
remains a physical acceptance step; unit tests are not a hardware certification.
Linux and untested hardware remain experimental. Integration/receivers are MIT;
the iPhone source remains proprietary.
0.2.3 - Public App Store onboarding
Public App Store onboarding
Publication correction: v0.2.3 is now a full release and marked latest for
the normal HACS channel. It was initially marked as a prerelease, leaving
normal HACS users on 0.1.17 without the administrator-service security fix.
The tested tag/commit and all archive/checksum bytes are unchanged. No beta
switch is needed to receive 0.2.3. Some immutable bundled onboarding text still
mentions prereleases; the current online instructions supersede that wording.
Presence Pair 1.0.0 (build 220) is Apple-approved and publicly listed free for
iOS 17+ in the Italian App Store.
Verified on November 4, 2026. No TestFlight invitation is needed for first enrollment.
This release updates documentation and version metadata only, retaining the
0.2.2 administrator-service security fix and required Bluetooth dependency.
No BLE protocol change, bond reset or forced re-enrollment is introduced.
Read the installation guide,
English tutorial,
Italian tutorial and
public-app test.
Install or upgrade
Default HACS catalog inclusion is still subject to
hacs/default#10597, not guaranteed.
Until accepted, add this as a HACS custom integration and select the latest full release.
Back up your configuration and verify SHA256SUMS.txt for downloaded packages.
The integration ZIP is flat: extract directly into custom_components/presence_bridge.
Restart HA after replacing component files. Working 0.2.2 receivers use the same
protocol; do not erase working associations for this documentation update.
Limits
Full-release distribution is not universal hardware certification. Linux/BlueZ and ARM
enrollment remain experimental. Record physical fresh/saved/partial-bond tests
separately; software tests and Apple approval do not establish those results.
The integration and receivers are free/MIT. The iPhone source remains proprietary.
0.2.2 - Administrator service security preview
Administrator service security fix
Upgrade the HA integration to restrict all four configuration services to
administrators: start/cancel pairing, assign receiver areas and remove identities.
Earlier releases protected the panel and WebSocket commands but omitted this
service-call boundary. Non-admin and unknown-user contexts now fail before
coordinator access. Admin responses and trusted internal automation calls remain
supported through HA's official helper.
Bluetooth remains a required dependency, with a regression test. The README now
links the pending App Store listing and clearly explains that initial enrollment
requires app access. No validation checks are disabled.
Installation
Back up HA, update the integration and restart HA once. Do not remove the
integration or working phone bonds. Matching HA, Windows and Linux ZIPs and
SHA256SUMS.txt are attached. Receiver re-enrollment is not required by this fix.
Keep scripts exposing privileged actions private.
Verification
- 26 real Home Assistant 2026.3.2 permission tests pass, including admin,
non-admin, unknown-user and internal-automation calls with/without responses. - HACS, hassfest, Windows and Linux validation pass without ignored checks.
- Each release archive is checked against source-file hashes and its public
contents allowlist, with SHA-256 checksums. - Source and tests: #8
- Validation: https://github.com/ravhello/presence-bridge/actions/runs/39522311074
Public preview boundary
This is a security preview for existing testers, not a public iPhone app launch.
As checked October 21, 2026, Presence Pair 1.0.0 build 220 is WAITING_FOR_REVIEW
at Apple; https://apps.apple.com/app/id6808059201 may not open before approval.
The integration cannot enroll a new iPhone without the app. The original HACS
catalog submission remains draft until public app availability is verified.
Linux remains experimental. Software validation does not certify a new radio,
every iPhone/driver combination or universal hardware compatibility. The iOS
app source remains proprietary; the integration and receivers remain MIT licensed.
0.2.1 - Saved-bond recovery preview
0.2.1 Recovery Preview
Presence Bridge and its receivers remain free and MIT licensed. The proprietary
iPhone app remains free during compatibility testing; App Store approval is separate.
Changes
- Preserve valid bonds during normal retry. Discovery timeout alone never proves
invalid keys and never grants permission to delete a saved bond. - Offer explicit administrator repair only for the exact failed Windows session
and uniquely identified phone. Offers expire and cannot affect a different phone. - Confirm receiver removal before clearing HA. Persist preparation for the same
person and receiver across cancellation, QR renewal and HA restart. - With Presence Pair 219 or newer, show the iPhone Settings preparation screen
before starting Bluetooth after verified server removal. iOS bond deletion is
manual; neither the app nor HA can silently remove it. - Keep proximity advertising active while pairing, release connection ownership
before cancellation, and refresh services after authenticated bonding. - Continue requiring the protected acknowledgement, HA identity commit and phone
receipt. A system paired-device entry is not enrollment success.
Install Or Upgrade
Back up HA and receiver state. Use matching 0.2.1 integration and receiver ZIPs;
verify SHA256SUMS.txt. In HACS enable pre-releases. Restart HA after replacing
integration Python files; update the receiver on the actual Bluetooth server.
Do not delete working bonds or remove the integration just to upgrade.
Windows enrollment needs its configured user signed in (locked is fine), an
adapter with BLE central and peripheral roles and MQTT. Linux remains opt-in and
experimental, with BlueZ, D-Bus and read-only bond storage requirements. Passive
proxies cannot perform first enrollment. See installation.
Verification Boundary
Automated tests exercise protected exchange, scoped removal, persistence,
timeouts, cancellation, app links and prerequisites. Archive validation checks
required files and source hashes. CI also exercises Linux-only storage cases.
These checks do not replace RF tests or certify every driver/iPhone combination.
On October 7, 2026, an owner-confirmed Presence Pair 219 physical recording
showed same-device HA launch, proximity guidance, protected exchange, phone
completion, persisted HA identity and fresh passive reception on one Windows
setup. The installed integration was recovery-patched 0.1.36 on HA 2026.9.4;
the receiver reported 0.1.35 with recovery patches. Its Windows enrollment files
match this preview; observer differences are version/manufacturer labels only.
This is not an exact 0.2.1 full-matrix test or Linux/hardware certification.
The app and private recording were submitted to Apple; approval is pending.
The complete acceptance checklist remains required before
promoting this integration to stable. This is an opt-in preview, not a claim
of universal compatibility or a completed App Store launch.
Rollback
Stop enrollment before rollback. Preserve a backup of HA's protected integration
storage and receiver configuration. Restore the matching previously working
integration and receiver packages, then restart their services. Do not publish
backups, keys, QR invitations or radio captures in an issue.
0.2.0 - Linux and installation preview
Public Compatibility Preview
The Home Assistant integration and receivers are free and MIT licensed.
Presence Pair remains a separate proprietary iPhone app, free during testing.
Installation
- HACS custom repository:
ravhello/presence-bridge, Integration category, pre-releases enabled. - Manual HA installation: extract
presence_bridge-0.2.0.zipintocustom_components/presence_bridge/(flat ZIP). - Windows: use the matching Windows ZIP and its installer.
- Linux (experimental): use local HA enrollment without MQTT where BlueZ/D-Bus and read-only bond storage are accessible, or the standalone systemd/Docker receiver with MQTT.
Read the installation chooser and Linux guide. HA OS and restricted NAS hosts may still need a separate receiver; passive Bluetooth proxies cannot enroll iPhones.
Changes
- Experimental headless Linux backend with authenticated selected-peer key checks, protected GATT acknowledgement and HA completion receipts.
- Scoped device removal, preserved observation timestamps and receiver-specific BlueZ identity resolution.
- Optional local transport removes the MQTT requirement on appropriately configured Linux HA hosts.
- Windows partial-bond and acknowledgement recovery improvements.
- Public panel/app links, prerequisite diagnostics, installation guides and hardware-report templates.
- Community Discussions and private vulnerability reporting enabled.
Verification And Limits
Windows CI, Linux Python 3.11/3.13 tests, Docker build, HACS, hassfest and documentation build passed before merge. Linux ran 64 software tests including real POSIX storage checks. Packages were checked for required files, source hashes and excluded private artifacts.
This is NOT a universal hardware certification. Linux physical iPhone/adapter tests, ARM hardware acceptance and the broader partial-bond matrix remain open. Do not use preview room inference for alarms, locks or life-safety decisions.
Back up HA and receiver state before upgrading. Existing Windows/MQTT installations do not enable Linux automatically. The iOS source/signing material and private diagnostic scripts are not included. Public App Store availability is separate and still depends on Apple's review and the demonstration video.
Presence Bridge 0.1.36 - Public Preview
Presence Bridge 0.1.36: public preview
Released on 2026-09-14 as a free, opt-in pre-release. The Home Assistant
integration and Windows receiver are public; the iPhone app remains in
TestFlight while its separate App Store submission is prepared.
Included
- QR-scoped iPhone pairing on a headless Windows receiver, protected Bluetooth
acknowledgement and verified HA identity storage before success. - Bounded saved-bond recovery and removal of the selected phone on its owning
receiver, without clearing unrelated devices. - Passive Windows and HA-native Bluetooth observations, fresh room estimates
and Person linking that preserves existing GPS/Wi-Fi trackers. - Live per-receiver dBm readings, packet timestamps and expiration of stale
measurements. RSSI is not a precise distance measurement in meters. - A separate, revocable, read-only HTTPS signal QR for the iPhone monitor.
Install
- Add
https://github.com/ravhello/presence-bridgeto HACS as a custom
Integration repository. This release is not a default HACS catalog listing. - Enable pre-releases for this repository and select v0.1.36. HACS excludes
betas by default; see its
pre-release switch documentation. - Install, restart HA, and add Presence Bridge from Devices & services.
- Extract
presence-bridge-windows-0.1.36.zipon the fixed Windows receiver
and runinstall.ps1as Administrator from the extracted directory.
For manual HA installation, extract presence_bridge-0.1.36.zip directly into
<HA config>/custom_components/presence_bridge/ and restart. The ZIP is flat;
manifest.json belongs directly inside that directory.
Download both packages.
Full tutorials:
English and
Italian.
Compatibility limits
Initial enrollment requires Presence Pair on iOS 17+ and a Windows Bluetooth
LE adapter with central and peripheral support. The configured Windows user
must be signed in; a locked session is sufficient. No PIN prompt needs to be
accepted on the receiver. Windows passive tracking runs as SYSTEM at startup.
The iPhone does not need Wi-Fi for Bluetooth pairing. The receiver needs a
network connection to HA/MQTT. The optional HTTPS live monitor separately needs
a network route from the iPhone to HA.
HA-native Bluetooth adapters and compatible proxies provide passive tracking,
not initial enrollment. Linux/BlueZ, ESPHome/Shelly/Sonoff initial enrollment,
Android enrollment and Apple Watch enrollment are not implemented.
The final public-flow demonstration, a clean install on another Windows host,
the new iOS monitor's physical tests and the wider phone/adapter matrix remain
pending. A saved working identity and unit tests do not certify those cases.
Read the compatibility matrix.
Verification
- 180 Python tests, Ruff lint/formatting, Windows installer ACL checks, HA
hassfest and all 9 HACS checks passed in
CI. - Packaged code is identical to tested source commit
89cf2714045dc35e8402441eca6cc0efda6d8635. Publication changes only documentation. - All 23 integration files and 13 receiver files match source hashes; private
configuration, credentials and diagnostic launchers are excluded. - Existing HA 2026.8.3 deployment was checked read-only with a linked identity
and fresh observations. Publication does not reset or restart that deployment.
SHA-256:
426f2afa6619ec2de970719d3a160ed646a90359be3408b36e49d076379a964a presence_bridge-0.1.36.zip
e8dc8f4118af1a32c093d63a71d2e3cc5bd4e977cbf0b37d1633e8b2ecb6adcb presence-bridge-windows-0.1.36.zip
Upgrade and recovery
Before updating, create an encrypted HA backup and securely back up the receiver
configuration. Keep the receiver ID unchanged. Update HA and Windows to the
matching version without dissociating a working phone. Do not open pairing
while installing or restarting either component.
If an update fails, pause only presence-dependent automations and use a
coordinated restoration of the previous HA backup and receiver version/config.
Do not delete identities or clear the Bluetooth adapter as a generic fix.
Older software is not guaranteed to understand newer stored data.
Report problems
Use GitHub issues
for the integration or Report a problem inside Presence Pair. Include HA,
Windows, adapter/driver, iOS, app build and receiver versions, the diagnostic
code, expected behavior and reproduction steps. Review diagnostics before
sending; do not attach QR codes, identity keys, credentials or HA backups.
Report security issues privately through the repository's Security tab.
Presence Bridge 0.1.17
Changes
- Completes resilient app-assisted iPhone pairing through a Windows Bluetooth receiver.
- Keeps the QR invitation valid for 10 minutes and grants a separate bounded completion window after handoff.
- Recovers stale Windows/iPhone bonds and transient WinRT adapter/service-discovery failures.
- Adds privacy-safe diagnostics, automatic pairing-task installation, and live Home Assistant progress.
- Updates the Home Assistant panel, protocol documentation, troubleshooting guidance, and Windows tests.
Validation: 51 local bridge tests passed; Ruff and frontend JavaScript checks passed.
Presence Bridge 0.1.2
Presence Bridge 0.1.2 keeps the Windows observer and Home Assistant integration on the same ten-minute pairing invitation limit.
Changes
- Align the packaged Windows observer protocol with the Home Assistant integration.
- Reject pairing invitations that exceed the documented ten-minute lifetime.
- Add regression coverage for both protocol implementations.
Validation
- 14 Python tests passed.
- Ruff lint and formatting checks passed.
- HACS and hassfest validation passed.
Presence Bridge v0.1.1
Changes
- Enforce the documented ten-minute maximum pairing lifetime throughout the public protocol.
- Add a complete English setup tutorial alongside the Italian guide.
- Move GitHub workflows to the current Node 24-based official Actions.
The Home Assistant integration remains free and open source. Presence Pair is a separate commercial iPhone companion.
Presence Bridge 0.1.0
First public release of Presence Bridge.
- Free, local-push Home Assistant integration with an administrator pairing panel
- Windows BLE observer with boot recovery and SYSTEM-task smoke checks
- App-assisted encrypted Bluetooth pairing for Presence Pair on iPhone
- Private BLE identity resolution with presence, room, and home/away tracker entities
- Redacted diagnostics, English and Italian translations, tutorials, troubleshooting, and privacy documentation
Install it now as a custom HACS repository or copy custom_components/presence_bridge into Home Assistant. The companion iPhone app is distributed separately.