< HomeKat Help

Frequently Asked Questions

Home Kat Bridge

Q: What does Home Kat Bridge do?

A: It runs a software bridge to connect supported devices and virtual accessories to HomeKit. After the bridge is paired, you control those accessories with Apple's Home app, Siri, scenes and automations.

Q: Does the app need to run all the time?

A: Yes. The host device must stay powered on, awake and connected to the same local network as the equipment it controls. If the app stops, sleeps or loses its network connection, its accessories become unavailable in HomeKit.

Q: If I run it on iPhone or iPad , can I still use the device normally ?

A: If used to connect remotely to a local running server, it behaves like any other normal app. However if using the iOS device as the bridge, the app must remain frontmost in Guided Access which blocks the use of any other app. Only use an old spare device dedicated to Home Kat Bridge. It can run on any devices supporting iOS 18, as far back as iPhone XS. Runinng on a stay at home Mac is more convenient when you want continue to use the machine for other purposes.

Q: Can I run Home Kat Bridge on more than one device?

A: Only one device on a network should act as the main Home Kat Bridge. When another active server is detected, the app enters remote-monitoring mode. It can show status, the Event Log and history charts, manage purchases and restart or shut down the server. Category switches are read-only remotely. The configuration is stored in iCloud, so after stopping one server you can run another device signed into the same iCloud account without creating a second bridge configuration.

Q: Why does HomeKit say the bridge is "Uncertified"?

A: Home Kat Bridge is software rather than certified HomeKit hardware. WHen pairing with Home Kat bridge or TV device, select Add Anyway when HomeKit prompts that the device is Uncertified.

Q: Why must each Harmony Hub be paired separately?

A: A Harmony Hub is presented as its own HomeKit television with its own setup code. This is a quirk of the way that HomeKit works, which does not permit TV devices to be bridged seperately. Harmony buttons and switches use the main bridge, but every television accessory must be paired from the Harmony page. It is possible to just setup custom buttons, which are shared on the main Home Kat Bridge, and thereby control the Harmony Hub without needing to pair the Television accessory at all.

Q: Can Home Kat Bridge support another device type or model?

A: Possibly. The developer needs usable local or cloud API details and access to a working device for testing. Contact the developer through the website with the exact manufacturer, model and hardware version.

Q: Where are my settings and account details stored?

A: The Home Kat Bridge configuration synchronises through your private iCloud account. Account passwords and API secrets used by supported device categories are stored securely in your system keychain. Diagnostic exports may contain device names, addresses and identifiers, so review them before sharing.

Apple's Home app

Q: Can I change an accessory's icon in the Home app?

A: Home Kat Bridge identifies the HomeKit accessory type, but Apple decides which icons and controls the Home app displays. The app cannot provide arbitrary Home icons.

Q: Where should I rename an accessory or assign its room?

A: The name and room displayed in the Home app is how to reference the device in Siri, scenes and automations. You can change the name in the Home app, but that won;t be preserved if the device is removed and added back. Changes to device names in the TP-Link or Tuya native apps are propagated to HomeKit. Some device categories also let you edit their source name in Home Kat Bridge.

Q: Will I lose my HomeKit rooms, scenes or automations if I re-pair Home Kat Bridge?

A: Home Kat Bridge retains preferred rooms and supported scene or automation actions for its accessories. Restoration begins after the bridge is added back and its accessories reappear. Missing scenes can be recreated, but Home Kat Bridge cannot recreate an automation trigger or its conditions; that automation must still exist and expose its action set. See HomeKit Settings and Assignment Recovery. HomeKit can sometimes reject room assignments, so restauration is not allways guaranteed.

Q: Can I control the accessories while away from home?

A: Home Kat Bridge and the physical devices must remain together on the home network. Remote access from Apple's Home app follows the normal HomeKit requirements, including an Apple home hub configured for remote access.

Q: Can I keep using the manufacturer's app or original remote?

A: Usually yes. State changes normally return to HomeKit when the device reports them. One-way infrared equipment is an exception: using another remote can leave HomeKit showing the last command it sent rather than the equipment's real state.

Subscriptions and the App Store

Q: Is there a trial period available?

A: One Category, Two Categories and All Categories subscriptions offer six-month and annual terms, with an introductory trial where shown by the App Store. A lifetime Golden Ticket is also available without a subscription.

Q: What is the difference between the subscription plans and a Golden Ticket?

A: One Category and Two Categories plans activate the number of categories in their names. All Categories activates every current and future category. The Golden Ticket provides the same all-category access as a one-time lifetime purchase. If a subscription remains active after buying a Golden Ticket, Home Kat Bridge warns you to cancel the unnecessary subscription through Apple.

Q: What is the difference between enabling and activating a category?

A: Enabling a category allows discovery, account connection and setup. Activation is supplied by your plan and allows that category's configured accessories to be added to HomeKit. An enabled but unactivated category has a yellow status indicator. With a One Category or Two Categories plan, stop the server and use the category pickers in Settings > General to change which categories are activated. See Plans, Purchases and Activated Categories.

Q: I already subscribed. How do I restore access?

A: Open Settings > General and select Restore Purchases. Restore Purchases is also available in Remote Settings. Make sure the device is signed into the Apple Account that made the purchase and has an internet connection.

Q: How do I cancel a subscription?

A: Subscriptions are managed by Apple rather than inside Home Kat Bridge. Follow Apple's instructions for viewing or cancelling subscriptions. Cancelling prevents the next renewal; access normally continues until the current paid period ends.

For device or network problems, see the troubleshooting guide.