Repository navigation
Releases
v1.2.0
🚧 Breaking changes
- None
✨ New features
- None
🐛 Bug fixes
- None
🔧 Improvements
- Keep active HomePod sensor reads running while another HomePod is still being set up.
- Avoid rewriting unchanged onboarding failures after a fresh authentication check, and reuse the accessory lookup across device selections.
- Successful automatic recovery silently clears any outstanding recovery alert. Failed recovery still raises an alert.
🔄 Other changes
- Set the integration manifest and project version to
1.2.0.
v1.1.1
🚧 Breaking changes
- None
✨ New features
- None
🐛 Bug fixes
- Keep credential updates and native-device transitions tied to the selected HomePod record. Ignore duplicate setup records for configured devices and prevent an in-progress credential update from recreating a removed device.
🔧 Improvements
- Reduce monitoring overhead by updating heartbeat progress one HomePod at a time and checking for stalled devices across the inventory once per poll, alongside the independent watchdog timer.
- Copy only the matching credential record during provisioning, and avoid rewriting the setup journal when repeated checks find the same HomePod still unreachable.
🔄 Other changes
- Set the integration manifest and project version to
1.1.1.
v1.1.0
🚧 Breaking changes
- None
✨ New features
- None
🐛 Bug fixes
- None
🔧 Improvements
- Start sensor monitoring before refreshing HomePod names in the background. Reuse a matching authenticated startup reading once if it is less than 30 seconds old. Later polls authenticate and read the sensors afresh.
- Try each HomePod's last known address first. If the address is unreachable or belongs to another accessory, try rediscovery and verify the HomePod's pinned identity before using a newly discovered address.
- Reduce polling overhead by avoiding copies of the credential inventory when saving monitoring state. Continue to write state durably.
🔄 Other changes
- Clarify the README's setup and recovery guidance for dedicated HomePod connections and devices transitioned from native HomeKit adoption.
- Set the integration manifest and project version to
1.1.0.
v1.0.1
🚧 Breaking changes
- Remove adoption, credential access, authentication, pairing recovery and reloads for native Home Assistant
homekit_controllerentries. Every sensor connection now uses an integration-owned regular User controller. Upgrade configuration entries to version 3: existing dedicated connections retain their identities, entities and safety counters; previously adopted devices pause until an administrator explicitly confirms separate connections and imports an independently obtained export. Their native entries, pairings and history remain untouched. New temperature/humidity entities are created only after confirmation; automatic recovery starts disabled for these transitions. - Replace native reload diagnostics with owned sensor publication diagnostics. Declare the aiohomekit dependency directly instead of loading
homekit_controller.
✨ New features
- None
🐛 Bug fixes
- None
🔧 Improvements
- None
🔄 Other changes
- Set the integration manifest and project version to
1.0.1.
v1.0.0
v1.0.0 - 2026-11-09
🚧 Breaking changes
- None
✨ New features
- Import irestore v0.4.0
keychain.jsondirectly through the existing credential form on macOS or Windows. Decode typed text/Base64 HAP attributes, preserve complete controller/accessory keys and identifiers, and discard deleted records and unrelated credentials. Allow bounded 2 MiB irestore dumps while retaining existing normalized limits, validation and device selection. Verified with synthetic fixtures only; real backups and HomePods remain untested.
🐛 Bug fixes
- Preserve task cancellation when aiohomekit suppresses it during connector shutdown, after closing the HAP transport.
- Keep device removal retryable when protected credential deletion fails or is interrupted; remove credentials before discarding live device state.
- Durably save the macOS wizard's original-settings snapshot and phase changes before continuing. Reject FIFO inputs without blocking and files that grow beyond the private-read size limit.
🔧 Improvements
- Remove unused setup bookkeeping and its redundant full-inventory copies. Delete credentials and recovery history in one atomic commit when removing a device, avoiding a second unchanged journal write.
- Resolve HAP and AirPlay browser inventories with at most 32 concurrent workers per browser, retaining all results and draining workers on cancellation or failure.
🔄 Other changes
- Set the integration manifest and project version to
1.0.0. - Mark the project active and add theme-aware sensor and device-management screenshots to the README.
- Add repository agent guidance and simplify the README setup instructions.
v0.2.0
v0.2.0 - 2026-11-08
🚧 Breaking changes
- None
✨ New features
- Add a guided macOS Terminal wizard and bundled Swift helper for user-authorised HomeKit extraction, with private progress across reboots, saved restoration instructions, and automatic JSON generation after security settings are restored. Select records by menu number without copying keys; remove the temporary key dump after verifying the saved JSON, and advise deleting or securely storing the JSON after HA setup succeeds. The helper compiles against Apple frameworks without the unavailable CodeSignKit/FoundationKit/LoggerKit packages. Signing/export require confirmation; security changes and restarts remain manual. Hardware verification is still outstanding.
- Build heartbeat monitoring into the integration and remove the optional automation blueprint from the repository and installation package. An independent five-minute timer alerts through Repairs and a persistent notification after 15 minutes without a completed device check, clears alerts when checks resume and respects startup grace, pauses and removal. Existing imported blueprint automations can be deleted manually.
- Choose a HomePod before opening its native action menu, with descriptions, a recovery action matching its current setting and a review step before changes. Require explicit confirmation before deleting local credentials and recovery history.
- Use a HomePod's AirPlay name during discovery and refresh existing device names when the integration loads. Require a unique match to freshly discovered sensor addresses; keep the current name when discovery fails or matching is ambiguous, and preserve Home Assistant device and entity name overrides.
🐛 Bug fixes
- Allow a corrected pairing export after an empty or failed search without restarting setup; searching again keeps the existing import.
- Confirm proposed names with fresh HAP and AirPlay DNS replies before saving them, preventing stale zeroconf cache addresses from assigning another HomePod's name after an address reassignment.
🔧 Improvements
- Clarify the confirmation shown after adding HomePods to an existing setup.
- Replace the empty HomePod selector with a clear message, local discovery guidance and options to search again or import a pairing export. Show a separate message when discovery fails.
- Simplify the credential-import instructions by removing the warning about posting credentials in issues or chat.
🔄 Other changes
- Bump the integration manifest and project version to
0.2.0. - Apply the five-category changelog layout to all releases.
v0.1.3
HomePod Sensor Link v0.1.3 completes the directed discovery fallback for hosts where replies do not reach the shared mDNS socket.
- Send the existing bounded HAP DNS-SD queries from temporary unicast UDP reply ports. Read fresh service, TXT and address records without modifying Home Assistant’s shared discovery cache.
- Close every temporary socket after success, failure, timeout or cancellation. Normal multicast discovery and authenticated HAP sessions continue using Home Assistant’s zeroconf instance.
- Keep v0.1.2’s pairing-dictionary address hints, missing-device import option, review-before-pairing flow, and administrator ownership checks.
- Include native Home Assistant credential forms for pasted CSV/JSON exports or manual credentials, a masked manual private-key field, protection against overlapping submissions, and clearer discovery/setup wording.
Requires Home Assistant 2026.11.0 or newer. Restart after updating, then open a fresh Reconfigure → Import pairing export to find missing devices session.
Validation: 236 offline tests with exact 100% Python statement and branch coverage, strict typing, hassfest, lint, formatting. The decoder also accepted complete fresh DNS-SD replies from all four expected devices through a live Home Assistant-side ephemeral-port probe. Complete setup and recovery remain separate hardware verification steps; this is still an experimental custom integration.
The archive includes a SHA-256 checksum and source provenance in package-evidence.json. External verification gates remain unchanged.
v0.1.2
HomePod Sensor Link v0.1.2 improves discovery when multicast browsing returns only some HomePods.
- Import an authorised aiohomekit pairing dictionary to use its literal address hints for bounded, directed HAP DNS-SD queries through Home Assistant’s shared zeroconf instance. Current advertisements supply the HAP ports; historical exported ports are unused.
- Reconfigure now offers Import pairing export to find missing devices. After import, review the newly discovered devices and recovery policy before pairing. Already active devices remain configured.
- Staged credentials stay tied to the importing administrator. Reauthentication retains its existing selection and identity checks.
Requires Home Assistant 2026.11.0 or newer. Restart Home Assistant after updating, then open a fresh Reconfigure session.
Validation: 232 offline tests with exact 100% Python statement and branch coverage, strict typing, hassfest, lint, formatting, and credential-panel JavaScript tests with 100% coverage. The changed read-only discovery helper also returned every expected identity in a four-device live check. Complete setup and recovery remain separate hardware verification steps; this is still an experimental custom integration.
The attached archive includes a SHA-256 checksum and source provenance in package-evidence.json. Existing external verification gates remain unchanged.
v0.1.1
HomePod Sensor Link v0.1.1 fixes credential-import compatibility and setup discovery.
- Accept aiohomekit JSON pairing dictionaries keyed by accessory ID, including exports with historical network metadata. Controller keys and accessory identity pins retain validation; historical endpoints are ignored.
- Actively browse for sensor services before listing setup candidates, instead of immediately snapshotting the discovery cache. A stale, invalid or unresolved service no longer hides healthy candidates.
- Select all discovered or resumable HomePods by default, and retain valid selections when correcting an input error.
Requires Home Assistant 2026.11.0 or newer. Restart Home Assistant after updating, then begin a fresh setup/import session.
Validated with 226 offline tests and exact 100% Python statement/branch coverage, strict typing, hassfest, lint, formatting, and credential-panel JavaScript tests and coverage. Synthetic tests do not establish complete real-device setup or recovery verification. This remains an experimental custom integration; an unresolvable sensor service may still require separate device/network troubleshooting.
The attached installation archive includes a SHA-256 checksum. Source and package provenance are recorded in package-evidence.json; the existing external verification gates remain unchanged.
v0.1.0
First experimental release of HomePod Sensor Link for Home Assistant 2026.11.0 or newer.
- Discover and select HomePods, import authorised HomeKit controller credentials, and provision a dedicated User controller for new temperature/humidity sensors.
- Adopt existing native HomeKit sensors while preserving their entity IDs, history and Apple Home pairings.
- Monitor fresh sensor readings and authentication every five minutes, with diagnostics, administrator-access audits and actionable Repairs issues.
- Enable optional pairing recovery by default per device, with pinned identities, add-only pairing preservation, startup grace, persisted repair limits and pending reload retries.
- Resume partial setup, retry or cancel onboarding, reauthenticate without resetting recovery history, and automatically delete owned credentials and local history on removal.
- Protect imported credentials with owner-bound upload grants, serialized uploads, private atomic storage, cancellation-safe cleanup and sanitised diagnostics.
- Reduce duplicate journal writes, per-sample entity updates and unrelated credential copies; clean up notifications/listeners when devices are removed or re-added.
- Include light/dark branding, Marketplace installation links, Wiki guides, an optional heartbeat automation blueprint and deterministic installation packages.
- Validate with 216 offline tests, exact 100% Python statement/branch and credential-panel JavaScript coverage, strict typing, hassfest, security/performance reviews and hosted CI.
Controller-key extraction and real-device setup/recovery still require verification. See the known limitations and credential prerequisites before installing. This release does not include a legacy migration or claim an official Home Assistant quality tier or HACS listing.
The ZIP contains custom_components/homepod_sensor_link for manual installation. A SHA-256 checksum is provided alongside it. Marketplace installations should select the tagged release.