UniFi Protect

UniFi Protect Driver Set Up Instructions:    CLICK HERE!                                                               

How To Guides:

Add 3rd Party Cameras

Add Programmable Custom Buttons

Email/Push Notifications

Add Doorbell Pro Package Camera Stream

Trigger Doorbell Announcement

• 20260129
  • Added Find Anything Driver to Protect solution.
  • Improved resiliency and reconnection between gateway and Protect.
  • Fixed (sensor): Some events were not being show under Composer Events when they should have.
  • 2026 Copyright update
•  20251224
  • Fixed issue with Sensor driver not populating events since V20251222
•  20251222
  • Improved UniFi Sensor tracking
  • Improved Camera Snapshot in OS4
  • Installed framework for future features.
•  20251208
  • boolean values were not tracking correctly
  • audio-alarm connection state was inverted
  • properties now correctly show/hide
  • Added External + Internal leak sensor inputs to match Protect sense devices
  • Added ViewHistory to Sense
  • Changed Audio-Alarm to Audible Alarm for clarity
•  20251107
  • Fixed playing a Chime Tone from Programming
  • Fixed Sense not connecting properly to "Temperature Display Driver"
  • Added connections for Leak + Audio Alarm
  • Fixed Sense leak alarm were not being allowed
  • Fixed 2.10.6 issue with JSON decoding

•  20251025
  • Added Protect Sense integration
  • Added Driver Feedback button to Gateway documentation
  • Added new Cindev/DriverCentral debug/ticketing integration
•  20250919
  • Fixed issue when a PTZ preset was deleted on UniFi, it was not deleting the preset on Control4 as well.
•  20250903
  • Removed block when gateway was not connected to UniFi to block Webhooks
  • Improved rest communication when UniFi or Protect was locked up or crashing.
•  20250902
  • Added Cindev Doorbell Integration to Protect Integration
  • Fixed issue where polling would stop in certain situations (out-of-range errorCode)
•  20250818
  • Fixed G2 Doorbell "ring" webhook (now monitored via two APIs for reliability)
  • Added Restart Protect Device command to Gateway
  • Added Refresh Communication command to Gateway
  • Improved 429 error handling — now retries after 5 minutes (no reboot needed)
  • Fixed RTSP mix-up between Package Camera and Doorbell Camera
•  20250611
  • Added support for alternate streams even when using Onvif
  • Added support for object based webhooks: Activity, Objects, Face ID, LPR license-plate. This will replace existing webhook integration and allows dealer to customize the monitored webhooks
  • Improved debug statements between WSS vs Webhook Events
  • Vehicle conditional now only displays known vehicles. Note: Vehicle conditionals now use saved ‘name’ of the vehicle not the license-plate (per UniFi Change).
  • Fix: Vehicle conditional not working
  • Fix: PTZ Presets could not be created if no presets had been created
  • Fix: OS4 not showing consistently showing Live View
  • Backend/Framework Updates and improvements
• 20250324     REQUIRES SYSTEM REBOOT
  • Added ONVIF/3rd Party Camera Support (Not Guaranteed to work with all 3rd party cameras)
  • Added AI Port integration
  • Fixed issue if hostname was being used instead of IPv4 address
  • Fixed PTZ presets not working
  • Added support for UniFi Access Cameras
  • Added support for sending Package Camera Snapshots
  • Added conditional programming for Detection zones
  • Fixed issue where cameras adopted by another UniFi system would cause errors
  • Improved communication/processing for all device calls
  • Fixed motion detection still showing even if the camera did not have Motion Events
• 20250104 - REQUIRES SYSTEM REBOOT
  • - Fixed issue with Viewport selection not always working
  • Driver now uses Webhooks for Event triggers - Watch Video
  • Support for 2.10.6 (Webhooks/Events) 
  • Dynamic Camera Events
    • Each camera will now only show Events that are allowed on that camera
    • A reboot of the Controller is required if upgrading
  • Added Vehicle Recognition
    • Conditional (Last Recognized Vehicle) contains a drop down of all found license plates - Watch Video
    • Removed: LastVechicleType, LastVehicleColor, LicensePlate Variables
  • Added Face Recognition
    • Conditional (Last Recognized Face) contains a drop down of all found faces and the tagged name for each - Watch Video
  • Added Support for Custom Webhooks
•  20241209
  • Fixed issue where legacy email notifications would not send properly when using a Role (owner/integrator)
  • Fixed PTZ preset commands not working since 20241114
•  202401115
  • Fixed issue where legacy versions of UniFi Protect would not load since Driver Version 20241114
•  20241114
  • Added Fingerprint Events (Doorbell Pro, Protect 5.1.45+)
  • Added NFC Card Events (Doorbell Pro, Protect 5.1.45+)
  • Fixed issue where events would trigger on a reload of the driver even if they occurred in the past.
  • Fixed ONLINE/OFFLINE state in Settings to be proper.
  • Fixed Chime Event trigger not working
•  20241108
  • Removed legacy code that is no longer in use
  • Fixed issue with Email+ driver not able to send snapshots
  • Improved snapshot speed
  • Added Command: Set Recording Options
•  20241014
  • Added double confirm to ‘Reload Gateway Connection’
  • General improvements and code performance
  • ViewPort Improvements:
    • Fixed BLUE button not working
    • New icon for ViewPort
    • Added Refresh Communication driver action
    • Added building cameras driver action (from Gateway)
    • Added better conditional programming with custom live-views
  • Light Improvements:
    • Fixed Variable LED Status not working
    • Added Advanced Lighting Support
    • Added Default Brightness
      • Property for selecting level
      • Composer Command for adjusting dynamically in Composer
    • Removed Last Event Property to improve performance of Director
    • Added Set Brightness Composer Command
  • Camera Driver Improvements:
    • Tested all Camera Model for functionality (see Gateway Documentation for complete report)
    • Improved organization and layout of Composer events, conditionals and commands
    • Added Camera Event History
    • Added Custom Buttons feature to Navigator
    • Added all AI events (object, audio, etc…) as Composer Events
    • Added/Fixed PTZ Control
    • Added PTZ Preset creation, manipulation and deletion on PTZ cameras
    • Fixed MOVE_TO not working from iOS when using a PTZ
    • Added improved Settings page
      • Customer can now change name of camera and it will also rename it in UniFi
      • Customer can adjust the Status LED on the camera
      • Customer and change the Doorbell Message
  • Fixed issues where video would not be available on remote C4 iOS app
  • Fixed Composer Command (Clear LCD Message) not working
  • Added enabling Streams directly from Composer using a Driver Action
•  20231025
  •  Added Driver-Add-Driver
    - The gateway driver can now add and configure cameras, lights and viewports with a single click (Driver Actions)
  • Added easy rtsp stream enabling
    - Under Driver Actions, dealers can now enable all Low, Medium or High RTSP streams for all cameras connected to UniFi. This greatly improves installation speed/configuration.
  • Added UniFi Chime support
    - The UniFi Chime can now be triggered via any Composer Event.
    - Can adjust the speaker volume from a Composer Event.
  • Fixed issues with Viewport and triggering unallowed liveviews
  • Improvement to Snapshots for Push + Email
  • General backend updates
•  20230528
  • Separated Refresh and Reload gateway connections
  • Refresh will attempt to re-login and add/append any new data/cameras found
  • Reload will remove connections and data stored in the driver for devices the user account no longer has access to or has been removed from the system
•  20230406
  • Added Dynamic Preset feature
    - This feature (disabled by default) allows dealers/customers to create buttons on the camera page to perform home automation actions. Examples would be 'Lights' to turn on/off lights in the camera view or 'Garage Door' which could toggle the garage door motor.
  • Added Settings feature
    - This feature (enabled by default) allows customers to 'see' last detection information and general camera info
  • Added 'Home' button hiding
    - Previously, the Home button was always available even if not being used for an advanced trigger action. OS 3.3.2+ allows drivers to dynamically adjust some of the navigator buttons. The home button is not 'hidden' by default.
  • Added PTZ controls
    - UniFi G4 PTZ camera is now supported including Pan, Tilt and Zoom controls. Note: Some G4 cameras also have an optical zoom feature. If the camera supports this, the ability to adjust the zoom will automatically be added to Navigator.
    - PTZ Preset triggers are also functioning
  • Improved customization of RTSP streams.
    - OS3.3.2+ allows for customized RTSP parameters for better camera experience for customers. The driver now allows dealers to customize these parameters if needed. To adjust the parameters, change Stream Settings Property to 'Manual' and you will be given the following options:
    - Stream Type, RTSPS enabled, Resolution, FPS
  • Other Changes:
    - Changed default stream resolution to 'Low'
    - Re-enabled the RTSP test feature
    - General backend improvements around detections/stream loading
•  20230118
  • Update to use new camera_v2 proxy commands (Control4 OS3.3.2+)
  • Added dynamic snapshots
  • Added liveview (iPhone)
  • Added support for different resolutions
  • Added line cross detection events
  • Added Package detection events
  • Added motion detection to Protect Light driver
  • Fixed issue with Protect light not toggling
•  20220228
  • Update to support future Control4 release
  • Improved documentation
• 20220102
  • Fixed login issue with 1.20.3
  • Default RTSP port is now linked to UniFi RTSP port automatically
  • Incorrect initial values for motion, doorbell, person, vehicle now fixed (was table, now integer)
• 20211215
  • Fixed issue where devices devices would report a table type and not integer under Motion/Person/Vehicle detection
• 20211111
  • Added Floodlight support
  • Fixed issue when a Liveview was deleted, the viewport would be unbound
  •  
    Changed ViewPort driver filename to correct version
     - unifi_viewport.c4z driver is end of life
     - unifi_protect_viewport.c4z is now current driver 
  • Fixed issue where Doorbell LCD message would not update if not time value was not given
  • Fixed issue if a Viewport or Light changed a setting it would cause other Viewports/Lights to become unbound in the driver
• 20210902 (Edge Release)
  • Fixed issue with contact bindings not triggering
• 20210608
  • Improved receiving events for smart detection and ring/doorbell pushes
• 20210522
  • Fix for locale issues
• 20210519
  • Fixed issue when multiple locales on same project
  • General websocket handling improvements
• 20210310
  • Fixed issue where cameras would not work on T4 touchscreens
  • Added ViewPort
• 20210305
  • Doorbell events added
  • Person events added
  • Vehicle events added
  • Prep work for Viewport integration
  • Improved communication/overall connections
• 1095
  • Improved communication with Cloud Key Gen2
  • Fixed issues where Push notifications with snapshots would not always work
  • Fixed issue where on reboot, the connections with the main gateway driver would be hidden
• 1094
  • Created new Gateway driver for better routing of messages to and from UniFi
  • Updated camera driver to support new gateway driver
    note: ALL jobs from now MUST have the gateway driver installed for protect NVR systems
• 1089
  • Protect NVR camera update Only
  • Fixed issue with some camera names causing driver not to work.
• 1086
  • Improved snapshot retrieval on Cloud Key Gen2 NVRs.  
  • Prepared for future UniFi products.
• 1084
  • Added support for Cloud Key Gen2
• 1082 
  • Initial Release