New UniFi Protect binding for OH 5.1

sidamos · December 30, 2025, 3:27pm

I just switched from OH 5.0.3 to 5.1 and also from the old UniFi Protect binding to the new one.

Now I have a few questions:

I can switch the status led of my G4 Instant on and off with the binding. But when I change that setting in the Protect iOS app, it is not being reflected in OH.

How do I control the recording mode from OH? I need to be able to switch from off to always + events only and back. But I did not find a channel for that.
In Home Assistant, which is AFAIK also using the API, one can configure that via “recording mode”.

Thanks!

@digitaldan

sidamos · January 1, 2026, 10:13am

I have another issue: When streaming video to a widget, go2rtc uses extreme amounts of memory over time, leading to a kernel OOM panic.

I have created 2 issues for my problems:

github.com/openhab/openhab-addons

[unifiprotect] No feedback from external changes, missing channel

opened 10:11AM - 01 Jan 26 UTC

sidamos

bug

## Expected Behavior I can switch the status led of my G4 Instant on and off wit…h the binding. But when I change that setting in the Protect iOS app, it is not being reflected in OH. How do I control the recording mode from OH? I need to be able to switch from off to always + events only and back. But I did not find a channel for that. In Home Assistant, which is AFAIK also using the API, both issues are not present. ## Current Behavior Would like to have feedback in OH from external changes and would like to have the missing channel. ## Your Environment * Version used: openHAB 5.1 * Environment name and version (e.g. Chrome 76, Java 8, Node.js 12.9, ...): N/A * Operating System and version (desktop or mobile, Windows 10, Raspbian Buster, ...): Linux

github.com/openhab/openhab-addons

[unifiprotect] High memory usage of go2rtc

opened 10:05AM - 01 Jan 26 UTC

sidamos

bug

## Expected Behavior Streaming video to widget should not use all memory. ## Cu…rrent Behavior go2rtc has high memory usage. ## Steps to Reproduce (for Bugs) I have added the webrtc widget from the binding doc to my Main UI tablet dashboard. The next morning, my Linux server has OOM kernel panic because of go2rtc. Later I restarted the UI and monitored the go2rtc process only to see that memory is rising all the time. Some output/log: Kernel panic: Jan 1 08:48:20 backend kernel: ib_log_wr_notif invoked oom-killer: gfp_mask=0x140cca(GFP_HIGHUSER_MOVABLE|__GFP_COMP), order=0, oom_score_adj=0 Jan 1 08:48:21 backend kernel: oom-kill:constraint=CONSTRAINT_NONE,nodemask=(null),cpuset=openrc.mysql,mems_allowed=0,global_oom,task_memcg=/170207,task=go2rtc,pid=31648,uid=1000 Later: mythtv 9995 28961 2 08:48 ? 00:02:43 /home/mythtv/openHAB/userdata/cache/org.openhab.binding.unifiprotect/bin/linux-amd64/go2rtc -config /home/mythtv/openHAB/userdata/cache/org.openhab.binding.unifiprotect/config/unifiprotect:camera:a6f92bc4b7:6264180401bbcb0387005aca.yaml 127.0.0.1:1984 PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND 9995 mythtv 20 0 1242384 28264 8 S 4.7 0.2 0:02.19 go2rtc 31690 mythtv 20 0 9883704 6.1g 8 S 4.3 39.3 84:08.44 go2rtc PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND 9995 mythtv 20 0 1919572 692692 8 S 5.0 4.2 2:38.47 go2rtc PID USER PR NI VIRT RES SHR S %CPU %MEM TIME+ COMMAND 9995 mythtv 20 0 2055644 846484 8 S 4.6 5.2 3:14.90 go2rtc ## Context At this time, the streaming to a widget is unusable for me. ## Your Environment * Version used: openHAB 5.1 * Environment name and version (e.g. Chrome 76, Java 8, Node.js 12.9, ...): Chrome browser and habpanelviewer app * Operating System and version (desktop or mobile, Windows 10, Raspbian Buster, ...): Linux

Matt_Schin · January 8, 2026, 8:16pm

Hi, great new binding! thanks"! i noticed a view things: i have a g4 doorbell. i receive the ring event twice. the item changes from closed to open and back to closed. some seconds later again to open and then again to closed. but the ring button was pushed only once.

also noticed that for my g5 bullet and g3 instant i can not find any trigger channels as mentioned in the docs

and when using the 2way audio, i push the microphone button on the video, browser has permissions but no sound is sent to the camera.

as this is not the official binding thread, i dont know if its ok to post this here but i learned for other bindings there is one thread with all issues/discussions. i can post somewhere else if more appreciated.

@digitaldan

DrRSatzteil · January 14, 2026, 6:55pm

Is this binding also supposed to work with a UDM SE? My NVR thing unfortunately stays offline. Nothing too relevant in the logs when I disable/enable the thing (debug level):

2026-01-14 19:52:47.165 [WARN ] [ty.util.ssl.SslContextFactory.config] - Trusting all certificates configured for Client@e38ddab[provider=null,keyStore=null,trustStore=null]
2026-01-14 19:52:47.165 [WARN ] [ty.util.ssl.SslContextFactory.config] - No Client EndPointIdentificationAlgorithm configured for Client@e38ddab[provider=null,keyStore=null,trustStore=null]

Edit: my log level change was not saved the first time. There is actually more output:

2026-01-14 20:04:10.141 [DEBUG] [ernal.handler.UnifiProtectNVRHandler] - Initializing NVR
2026-01-14 20:04:10.142 [DEBUG] [ernal.handler.UnifiProtectNVRHandler] - Initialization failed
java.lang.IllegalStateException: Failed to start Jetty clients
        at org.openhab.binding.unifiprotect.internal.api.UniFiProtectApiClient.<init>(UniFiProtectApiClient.java:111) ~[?:?]
        at org.openhab.binding.unifiprotect.internal.handler.UnifiProtectNVRHandler.lambda$1(UnifiProtectNVRHandler.java:144) ~[?:?]
        at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:572) ~[?:?]
        at java.util.concurrent.FutureTask.run(FutureTask.java:317) ~[?:?]
        at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(ScheduledThreadPoolExecutor.java:304) ~[?:?]
        at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1144) ~[?:?]
        at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:642) ~[?:?]
        at java.lang.Thread.run(Thread.java:1583) [?:?]
Caused by: java.lang.IllegalStateException: HttpClient is not running (did you forget to start it?): HttpClient@c7db033{STOPPED}
        at org.eclipse.jetty.websocket.client.WebSocketClient.doStart(WebSocketClient.java:416) ~[?:?]
        at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:73) ~[?:?]
        at org.openhab.binding.unifiprotect.internal.api.UniFiProtectApiClient.<init>(UniFiProtectApiClient.java:109) ~[?:?]
        ... 7 more
2026-01-14 20:04:15.143 [DEBUG] [ernal.handler.UnifiProtectNVRHandler] - Initializing NVR
2026-01-14 20:04:15.144 [DEBUG] [ernal.handler.UnifiProtectNVRHandler] - Initialization failed
java.lang.IllegalStateException: Failed to start Jetty clients
        at org.openhab.binding.unifiprotect.internal.api.UniFiProtectApiClient.<init>(UniFiProtectApiClient.java:111) ~[?:?]
        at org.openhab.binding.unifiprotect.internal.handler.UnifiProtectNVRHandler.lambda$1(UnifiProtectNVRHandler.java:144) ~[?:?]
        at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:572) ~[?:?]
        at java.util.concurrent.FutureTask.run(FutureTask.java:317) ~[?:?]
        at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(ScheduledThreadPoolExecutor.java:304) ~[?:?]
        at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1144) ~[?:?]
        at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:642) ~[?:?]
        at java.lang.Thread.run(Thread.java:1583) [?:?]
Caused by: java.lang.IllegalStateException: HttpClient is not running (did you forget to start it?): HttpClient@c7db033{STOPPED}
        at org.eclipse.jetty.websocket.client.WebSocketClient.doStart(WebSocketClient.java:416) ~[?:?]
        at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:73) ~[?:?]
        at org.openhab.binding.unifiprotect.internal.api.UniFiProtectApiClient.<init>(UniFiProtectApiClient.java:109) ~[?:?]
        ... 7 more
2026-01-14 20:04:20.145 [DEBUG] [ernal.handler.UnifiProtectNVRHandler] - Initializing NVR
2026-01-14 20:04:20.146 [DEBUG] [ernal.handler.UnifiProtectNVRHandler] - Initialization failed
java.lang.IllegalStateException: Failed to start Jetty clients
        at org.openhab.binding.unifiprotect.internal.api.UniFiProtectApiClient.<init>(UniFiProtectApiClient.java:111) ~[?:?]
        at org.openhab.binding.unifiprotect.internal.handler.UnifiProtectNVRHandler.lambda$1(UnifiProtectNVRHandler.java:144) ~[?:?]
        at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:572) ~[?:?]
        at java.util.concurrent.FutureTask.run(FutureTask.java:317) ~[?:?]
        at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(ScheduledThreadPoolExecutor.java:304) ~[?:?]
        at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1144) ~[?:?]
        at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:642) ~[?:?]
        at java.lang.Thread.run(Thread.java:1583) [?:?]
Caused by: java.lang.IllegalStateException: HttpClient is not running (did you forget to start it?): HttpClient@c7db033{STOPPED}
        at org.eclipse.jetty.websocket.client.WebSocketClient.doStart(WebSocketClient.java:416) ~[?:?]
        at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:73) ~[?:?]
        at org.openhab.binding.unifiprotect.internal.api.UniFiProtectApiClient.<init>(UniFiProtectApiClient.java:109) ~[?:?]
        ... 7 more
thomas@openhab:~$

sidamos · February 15, 2026, 5:24pm

Same here. I opened an issue:

github.com/openhab/openhab-addons

[unifiprotect] Ring reported twice

opened 05:21PM - 15 Feb 26 UTC

sidamos

bug

When someone rings my G4 Doorbell, I get the ring event twice via the ring-conta…ct channel. The 2nd event is over 10 seconds later and the person has not pushed the button twice. ## Expected Behavior For one ring, the ring-contact should open and then close. ## Current Behavior See this log: ``` 2026-02-15 17:19:24.564 [INFO ] [openhab.event.ItemStateChangedEvent ] - Item 'Doorbell_Camera_Doorbell_Ring' changed from CLOSED to OPEN (source: org.openhab.core.thing$unifiprotect:camera:a6f92bc4b7:6264180401bbcb0387005aca:ring-contact) 2026-02-15 17:19:29.564 [INFO ] [openhab.event.ItemStateChangedEvent ] - Item 'Doorbell_Camera_Doorbell_Ring' changed from OPEN to CLOSED (source: org.openhab.core.thing$unifiprotect:camera:a6f92bc4b7:6264180401bbcb0387005aca:ring-contact) 2026-02-15 17:19:40.812 [INFO ] [openhab.event.ItemStateChangedEvent ] - Item 'Doorbell_Camera_Doorbell_Ring' changed from CLOSED to OPEN (source: org.openhab.core.thing$unifiprotect:camera:a6f92bc4b7:6264180401bbcb0387005aca:ring-contact) 2026-02-15 17:19:45.811 [INFO ] [openhab.event.ItemStateChangedEvent ] - Item 'Doorbell_Camera_Doorbell_Ring' changed from OPEN to CLOSED (source: org.openhab.core.thing$unifiprotect:camera:a6f92bc4b7:6264180401bbcb0387005aca:ring-contact) ``` ## Possible Solution I could only try to de-bounce that in a rule. ## Steps to Reproduce (for Bugs) 1. Create item for ring-contact 2. Ring ## Context I have a rule that shows a special page when someone rings. Because I get the event twice, the page refreshes at the 2nd ring event. ## Your Environment * Version used: openHAB 5.1.2 * Environment name and version (e.g. Chrome 76, Java 8, Node.js 12.9, ...): Chrome browser and habpanelviewer app * Operating System and version (desktop or mobile, Windows 10, Raspbian Buster, ...): Linux

DrRSatzteil · February 15, 2026, 9:44pm

For those of you who got the binding working: What NVR device are you using?

sidamos · February 16, 2026, 5:04am

UDM-Pro.

Matt_Schin · February 16, 2026, 4:18pm

Keygen 2plus

digitaldan · February 16, 2026, 4:21pm

Sorry, i missed the comments on this thread. If there are issues with the binding please open a github ticket, its the best way to get my attention.

I also i have a huge PR i will open up soon that adds in the private api, so the binding will use both apis, this will basically expose every possible feature to openHAB (was trying to avoid the private api, but the public one is just not complete enough yet).

ErikDB · February 16, 2026, 5:34pm

Aha! That way, all the channels that were there in the old binding (e.g. is-dark) will also be there in your binding?

digitaldan · February 16, 2026, 6:33pm

Yes, is-dark is there and working, i just need to review it one more time before opening a PR, its a lot of code as it speaks to two very different APIs (and looking around, it seems using both is how other projects are doing it as well).

ThaDaVos · March 7, 2026, 2:13pm

For some reason none of my devices have channels at all - the is-dark one was the actual one I was looking for as I use it to trigger lights outside when it’s dark

Any idea when this will be merged?

ErikDB · March 17, 2026, 6:44am

I’m looking forward to it as well! Hope you soon find time for your magic, @digitaldan

digitaldan · April 2, 2026, 2:27pm

Hi sorry for the late reply, i finally got a PR open for this, hopefully this gets reviewed soon and into our nightly builds.

The README has the full list of camera channels, its very long

github.com/digitaldan/openhab-addons

bundles/org.openhab.binding.unifiprotect/README.md

edb871abb

# UniFi Protect Binding

This binding integrates Ubiquiti UniFi Protect into openHAB.
It connects to your Protect NVR/CloudKey/UNVR and provides live events and configurable settings for Cameras, Floodlights, Sensors, Doorlocks, and Chimes.

It primarily uses the Private API for device control and monitoring, with the official Protect Integration API (Public API) used for real-time event streaming, WebRTC/RTSPS streams, and talkback sessions.
The binding automatically manages API authentication, including auto-creation of API keys when needed.

## Features

- Supports multiple Protect devices (Cameras, Doorbells, Floodlights, Sensors)
- Has granular triggers and channels for realtime motion events including AI object detection, audio, and line crossing events.
- Uses websockets for realtime updates without polling
- Supports [WebRTC streaming](#real-time-media) for cameras with very low server CPU overhead
- Supports [2-way audio](#talkback-support-2-way-audio) for cameras that support it
- Uses STUN for external access to cameras when outside your local network (e.g. when using the openHAB cloud service)
- Provides general purpose image snapshot API endpoints for cameras

## Native Binaries

This file has been truncated. show original

PR:

github.com/openhab/openhab-addons

[unifiprotect] Private API Refactor (#20480)

main ← digitaldan:unifiprotect-private-api

opened 01:58PM - 30 Mar 26 UTC

digitaldan

+10060 -1508

This is a major refactor of the Unifi Protect binding to use the private API. U…nfortunately the public API Ubiquity publishes was just too limited and like other projects, we need to leverage the private API to expose commonly used features. This now uses both API's , but more heavily favors the private API where there is overlap. The binding now requires a local username and password, similar to the unifi network binding. It will use this to also request a key for the public API. Along with new channels and features, this also upgrades us to the latest go2RTC binaries which should solve some known issues. I have been using this for a couple on months on my home system to make sure its "soaked" in and tested.

ErikDB · April 9, 2026, 4:54am

@digitaldan, this question mark seems odd?

digitaldan · April 9, 2026, 12:52pm

Its hard to see with only a partial screenshot and no description, Can you elaborate where you are seeing this and maybe a little more of the UI ? I think its a channel description, but the online status seems odd there. In any case it seems like it trying to load a missing icon for the openHAB channel semantic tag, but i’m not seeing that on my system.

ErikDB · April 9, 2026, 1:51pm

Apologies, I thought that would have been enough. Also, I was on my phone, which is less convenient for screen shots.

It shows a Channel Link, from an Item UI view. Some more detail:

When looking at it from the Thing UI view, there’s an icon:

But where there’s an I for is-dark:

… there’s also ? in the Item UI view (although now there’s no icon to be loaded, just a letter I):

digitaldan · April 10, 2026, 1:00pm

These are just semantic tags issues with the Main UI for those couple of more advanced channels, they don’t affect the functionality at all of the binding or channel. I’ll see if i can update the xml description for those channels next time i make an update to something else in the binding.

ErikDB · April 10, 2026, 3:25pm

I didn’t assume there were any functional problems. But I reckon you like to dot the i’s and cross the t’s

ErikDB · April 16, 2026, 4:34am

@digitaldan, I don’t see anything about this enhancement in the overview of changes of 5.1.4?

But the PR was merged?