Skip to content
thereprocase / All projectsHOME-AUTOMATIONSource on GitHub ↗

HOMEKIT PREVIEW / BRIDGE INSPECTOR

Know what the bridge
is exposing.

Inspect Home Assistant’s HomeKit Bridge configuration by room, device and entity. Choose the exact entities you want, preview the filter, then apply it from the integration.

Try the filter example Install with HACS

Whole domain or selected entities?

Interactive explanation with sample entities. This illustrates one domain’s include rule. It is not connected to Home Assistant and does not reproduce Apple Home.

OR CHOOSE SPECIFIC ENTITIES

CONFIGURED TO INCLUDE / SAMPLE SET

3 of 3 sample switches

  • switch.desk_lamp
  • switch.workbench
  • switch.garden_lights

Include filter

{
  "include_domains": ["switch"]
}

The entire domain includes every supported switch, including ones added later.

What the integration adds

Bridge selection
Choose a bridge or accessory, then scan its current configuration.
Builder
Navigate room, device and entity views. Add or remove one entity at a time, with warnings for broad domain inclusion.
Preview & browse
Inspect the live preview, browse candidates, or read the raw filter before applying it.
Apply
The integration writes the selected bridge filter and reloads that HomeKit entry.
Automation hooks
A scan button, a preview sensor, the homekit_preview.scan action and a persistent Markdown notification expose the same information.

Install with HACS

Add this public repository as a custom HACS integration:

CUSTOM REPOSITORY URL
https://github.com/thereprocase/homekit-preview
  1. Open HACS → Custom repositories, add the URL, and choose Integration.
  2. Download HomeKit Preview and restart Home Assistant.
  3. Open Settings → Devices & services → Add integration, then select HomeKit Preview.
  4. Open its sidebar item and choose Scan / Refresh.

Keep HomeKit Bridge installed; Preview reads and edits its configuration.

Why domain-wide inclusion matters

Including a domain without choosing specific entities includes all supported entities in that domain. To expose only some switches, for example, select those entities and remove the broad switch-domain include.

In the actual Builder, adding one entity removes the domain-wide include for its domain and switches it to selected-entity mode. Review the preview before choosing Apply to HomeKit Bridge.

The example above intentionally covers only inclusion within one sample domain. Your real bridge may also have exclusions, unsupported entities and configuration from YAML.

Manual installation & project boundary

Copy the repository’s custom_components/homekit_preview directory into:

HOME ASSISTANT DIRECTORY
/config/custom_components/homekit_preview

Restart Home Assistant and add the integration through Settings.

This is a Home Assistant-side configuration tool in early development. Apple Home may rename, move, cache or hide entities after pairing. YAML-managed entries may overwrite UI changes later.

Browse the integration source Read the full guide