Skip to content

Known Limitations

barneyonline edited this page Nov 10, 2026 · 9 revisions
HomePod Sensor Link — Known Limitations

Known limitations

  • Temperature/humidity sensors require HomePod mini or HomePod (2nd generation), software 16.3+.
  • An export may omit required HomeKit records or contain incomplete key values. The HA integration imports credentials you provide; it does not extract backups or keychains. See the credential extraction methods for macOS and Windows.
  • Native irestore JSON import is implemented on main but is not part of the published v0.2.0 release as of 9 November 2026. Its 2 MiB input allowance applies only to builds containing that feature; other accepted CSV/JSON formats retain a 128 KiB limit. See credential import troubleshooting.
  • The macOS wizard requires an Apple silicon Mac, Python 3.9+, Xcode or its Command Line Tools and a valid Apple Development certificate. SIP/AMFI changes and restarts are manual.
  • Measurements use dedicated integration-owned controllers. Native HomeKit entries and history remain separate.
  • A dedicated User pairing reduces administrator authority but is not an accessory-enforced temperature-only capability.
  • HTTP import sends credentials without encryption; use HTTPS to protect them in transit.
  • Creating a dedicated connection requires administrator credentials and accessory identity even when recovery is disabled. A readable temperature/humidity sensor layout is required.
  • Resume and re-import require the original controller identity and keys.
  • Removal deletes local owned credentials and recovery history, but does not revoke on-device pairing records or erase backups/exports.

See credential extraction, setup and security for practical guidance.

Clone this wiki locally