✅ Yubii Home / Fibaro HC3/HC3L

✅ Standalone

The UniFi Protect plugin connects AutomationBridge to your Protect console using a local API key. It discovers your cameras and provides motion sensors, doorbell press events and supported camera controls.

This guide covers UniFi Protect 7.2 or later running on a UniFi OS console.

Before you start

Make sure:

• UniFi Protect and your cameras are working in the UniFi Protect app.

• AutomationBridge has the software update containing the API-key connection.

• Your Protect console has a fixed local IPv4 address, either configured directly or reserved through DHCP.

• AutomationBridge can communicate with the console and cameras over your local network.

The API-key connection retrieves snapshots through Protect. You do not need to configure anonymous snapshots on individual cameras.

1. Create your API key

1. Open your UniFi console directly using its local address and sign in as an administrator.

2. Open Protect → Integrations. On some versions, this is under Settings → Control Plane → Integrations.

3. Create an API key named AutomationBridge (with permission to read your cameras and events and manage camera streams and LEDs if required).

4. Copy the key. UniFi displays it only when it is created.

Use the integration key from the local console running Protect. The plugin’s local connection requires this key rather than a Site Manager or Fabric cloud API key.

2. Connect AutomationBridge

For an existing username/password installation, follow the upgrade instructions in the next section.

1. Open Network Devices/Plugins on AutomationBridge.

2. Add the UniFi Protect (UniFi OS) plugin.

3. Complete the connection fields:

1. Select Test and connect.

2. Keep the page open while AutomationBridge checks the connection. This may take a few minutes.

3. When the connection succeeds, select Open camera settings.

The connection test checks the Protect version, camera access, snapshots, live events and RTSP playback. It can enable the stream quality needed by the plugin.

If a certificate error is reported, expand Console certificate help, select Install certificate, then reboot AutomationBridge. Return to the connection page and repeat the test.

Upgrading an existing connection

Use Upgrade connection to retain your existing camera and sensor devices.

1. Open the UniFi Protect plugin settings and select Upgrade connection.

2. Create a local API key using the instructions above.

3. Enter the key and check the RTSP port. Your existing console address and HTTPS port are retained.

4. Select Test and upgrade and keep the page open until validation finishes.

The upgrade preserves camera and sensor IDs, existing automation links and HomeKit pairing identities. Existing camera names and HomeKit recording preferences are retained.

If validation fails, follow the displayed instructions and retry. If the connection is saved but a device or service refresh needs another attempt, open camera settings and select Sync.

Recording controls on Fibaro HC3 / HC3L

The new API does not provide the previous Never, Always and Detections recording-mode controls. Manage these settings in Protect’s Recording Manager.

If your existing HC3 installation contains the plugin’s {camera name} CAM recording-control Quick Apps, those obsolete controls are removed after the upgrade completes successfully. Camera, motion, doorbell and supported LED devices remain.

Any scenes that reference the removed recording-control Quick Apps will need updating. New installations do not create these controls.

3. Review your cameras and devices

The plugin settings page shows your cameras, snapshots and associated device IDs. It also displays Doorbell: Yes or Doorbell: No.

Depending on the camera and platform, the plugin provides:

Supported object detections, such as people and vehicles, activate the same motion sensor as ordinary motion events.

Select Sync after adding cameras or changing relevant settings in Protect. Sync discovers new cameras and refreshes existing connections while retaining existing device identities and names. Existing cameras are kept if they are temporarily offline.

To replace an API key, select Update API key beside Sync, enter the replacement key, then select Test and update key.

4. Add cameras to Apple Home

Enable the cameras you want to use with HomeKit from the AutomationBridge home page, then open the HomeKit page.

Each camera or doorbell must be added individually in Apple Home:

1. Open Apple Home on your iPhone or iPad.

2. Tap + → Add Accessory → More Options.

3. Select the camera or doorbell.

4. Enter the HomeKit code displayed on AutomationBridge’s HomeKit page.

5. Complete the room and naming options, then repeat for each camera.

The code is displayed in ####-#### format.

Pairing the AutomationBridge bridge does not automatically pair its cameras. Cameras already paired before an API-key upgrade retain their pairing.

Doorbell notifications

Recognised doorbells appear as Doorbell on the AutomationBridge HomeKit page.

Use an Apple Home with a connected Apple TV or HomePod home hub. You can check its status under Home Settings → Home Hubs & Bridges. See Apple’s home hub setup instructions.

Open the doorbell’s settings in Apple Home, select Status and Notifications, and enable Doorbell Notifications. Press the physical doorbell button to test.

Two-way audio

Supported doorbells can provide two-way audio through Apple Home.

Ensure the doorbell’s microphone is enabled in Protect, then run Sync. Open its live view in Apple Home and use the Talk or microphone control.

Availability depends on the microphone and speaker capabilities reported by Protect. Talkback uses the main doorbell view; package camera views do not provide a separate talkback connection.

5. Optional HomeKit Secure Video

HomeKit Secure Video—HKSV—allows activity clips to be recorded and viewed in Apple Home. It is off by default and is configured separately for each camera on AutomationBridge’s HomeKit page.

You need an Apple TV or HomePod home hub and an iCloud+ plan with an available camera allowance. See Apple’s HomeKit Secure Video requirements.

To enable it:

1. Open the HomeKit page on AutomationBridge.

2. Select the gear icon beside the camera.

3. Review the camera feed check.

4. Enable HomeKit Secure Video and select Save. HomeKit accessories briefly reconnect when the setting changes.

5. In Apple Home, open the camera’s Recording Options and choose Stream & Allow Recording for the required Home and Away states.

Apple Home also controls whether recordings include audio.

An H.264 feed is required to enable HKSV. If the feed uses H.265, the page displays a warning and does not offer the enable option. Change the camera’s stream to H.264 and reopen the page. Enabling is also unavailable if the feed cannot be checked.

Some H.264 feeds still need conversion to match HomeKit’s recording settings. Review any warnings and start with one camera before enabling additional cameras.

The HomeKit page’s HKSV column shows whether recording support is enabled on AutomationBridge. Apple Home’s settings determine whether recording is currently allowed.

To test, trigger motion in front of the camera and check that a new clip appears and plays in Apple Home. Protect must generate the detection event, and Apple Home must allow recording for your current Home or Away state.

Google Assistant

Where Google Assistant is configured, supported cameras and motion sensors can also be enabled from the AutomationBridge home page. Camera viewing depends on the receiving device and the capabilities of the Google integration.

Troubleshooting

Incoming motion, object detection and doorbell events can be checked through Bridge Logs in the unifiprotect_uoswatcher log. Event timestamps use the bridge’s local time.