Skip to content
This repository has been archived by the owner on Aug 26, 2022. It is now read-only.

Releases: briis/unifiprotect

Version 0.12.0

26 Jan 01:26
e575460
Compare
Choose a tag to compare

⚠️ ⚠️ WARNING ABOUT Home Assistant v2022.2

The unifiprotect integration will be in Home Assistant core v2022.2. If you are running 0.10.x or older of the HACS integration, do not install v2022.2.x of Home Assistant core.

If you are running 0.11.x or the 0.12.0, you should be safe to delete the HACS version as part of your upgrade. The 0.11.x branch is designed to be compatible with the 0.12.0-beta and the HA core version. The latest version of 0.12.0-beta will be the version of unifiprotect in HA core in v2022.0.

This repo is now deprecated in favor of the Home Assistant core version. This repo will be archived and removed from HACS after the 2022.4 release of Home Assistant.

Migration to HA Core Version Steps

If you have Smart Sensor devices and you are not running 0.12.0-beta10 or newer, it is recommended you just delete your UniFi Protect integration config and re-add it. If you do not have Smart Sensor devices, you can migrate to the Home Assistant core version by following the steps below:

  1. Upgrade to the 0.12.0 version for the HACS unifiprotect integration and restart Home Assistant.
  2. Remove your HACS unifiprotect integration from HACS (do not remove your unifiprotect config entry). It is safe to ignore the warning about needing to remove your config first.
  3. Do not restart HA yet.
  4. Upgrade to Home Assistant 2022.2.x

You must remove the HACS integration efore upgrading to 2022.2.0 first to prevent a conflicting version of pyunifiprotect from being installed.


0.12.0 was originally planned as a beta only release, but after giving it more thought, I figured it would be be great to mark it as stable for the folks that cannot upgrade to the HA core version in 2022.2.

This release is primarily fixes from the HA core process. There is also full support added for the G4 Doorbell Pro, the UP Sense.

This will be the last HACS release. After this point, the HACS repo is considered deprecated. We will still take issues in the repo as if people prefer to make them here instead of the HA core repo. But after a month or 2 we plan to archive the repo and have the integration removed from HACS.

Differences between HACS version 0.12.0 and HA 2022.2.0b1 version:

HACS Only

  • Migration code for updating from 0.10.x or older still exists; this code has been removed in the HA core version

HA Core Only

  • Full language support. All of the languages HA core supports via Lokalise has been added to the ingration.

  • Auto-discovery. If you have a Dream machine or a Cloud Key/UNVR on the same VLAN, the UniFi Protect integration will automatically be discovered and prompted for setup.

  • UP Doorlock support. The HA core version has full support for the newly release EA UP Doorlock.

Changes

  • CHANGE: BREAKING CHANGE Removes all deprecations outlined in the 0.11.x release.

  • CHANGE: BREAKING CHANGE The "Chime Duration" number entity has been replaced with a "Chime Type" select entity. This makes Home Assistant work the same way as UniFi Protect. (https://github.com/briis/unifiprotect/issues/451)

  • CHANGE: BREAKING CHANGE Smart Sensor support has been overhauled and improved. If you have Smart Sensors, it is highly recommended to delete your UniFi Protect integration config and re-add it. Some of the categories for the sensors have changed and it is not easy to change those without re-adding the integration. The sensors for the Smart Sensor are may also appear unavaiable if that sensor is not configured to be abled. For example, if your have motion disabled on your Sensor in UniFi Protect, the motion sensor will be unavaiable in Home Assistnat. Full list of new Smart Sensor entites:

    • Alarm Sound and Tampering binary sensors
    • Motion Sensitivity number
    • Mount Type and Paired Camera selects
    • Status Light switch
    • Configuration switches for various sensors:
      • Motion Detection switch
      • Temperature Sensor switch
      • Humidity Sensor switch
      • Light Sensor switch
      • Alarm Sound Detection switch
  • CHANGE: BREAKING CHANGE Removes profile_ws debug service. Core plans to add a more centralized way of getting debug information from an integration. This will be back in some form after that feature is added (estimate: 1-2 major core releases).

  • CHANGE: BREAKING CHANGE Removes event_thumbnail attribute and associated ThumbnailProxyView. After a lot of discussion, core does not want to add more attributes with access tokens inside of attributes. We plan to add back event thumbnails in some form again. If you would like to follow along with the dicussion, checkout the architecure dicussion for it.

  • CHANGE: Switches Doorbell binary_sensor to use is_ringing attr, should great improve relaiability of the sensor

  • CHANGE: Dynamic select options for Doorbell Text

  • CHANGE: Improves names for a number of entities

  • CHANGE: Adds a bunch of extra debug logging for entity updates

  • NEW: Adds full support for the package camera for the G4 Doorbell Pro. It should now always be enabled by default (if you are upgrading from an older version, it will still be disabled). The snapshot for the Package Camera has also been fixed. Since the camera if only 2 FPS, streaming is disabled to prevent buffering.

  • FIX: Overhaul of the Websocket code. Websocket reconnects should be drastically improved. Hopefully all reconnnect issues should be gone now.

  • FIX: Fixes NVR memory sensor if no data is reported

  • FIX: Fixes spelling typo with Recording Capacity sensor (https://github.com/briis/unifiprotect/issues/440)

  • FIX: Fixes is_connected check for cameras

  • FIX: Adds back last_trip_time attribute to camera motion entity

  • FIX: Fixes NVR memory sensor if no data is reported

  • FIX: Fixes spelling typo with Recording Capacity sensor (https://github.com/briis/unifiprotect/issues/440)

  • FIX: Further improves relibility of Doorbell binary_sensor

  • FIX: Fixes voltage unit for doorbell voltage sensor

  • FIX: Fixes connection_host for Cameras so it can have DNS hosts in addition to IPs.

  • FIX: Improves relibility of entities when UniFi Protect goes offline and/or a device goes offline. Everything recovery seemlessly when UniFi Protect upgrades or firmware updates are applied (fixes https://github.com/briis/unifiprotect/issues/432).

  • FIX: Improves relibility of media_player entities so they should report state better and be able to play longer audio clips.

  • FIX: Fixes stopping in progress audio for media_player entities.

  • FIX: Allows DNS hosts in addition to IP addresses (fixes https://github.com/briis/unifiprotect/issues/431).

  • FIX: Fixes selection of default camera entity for when it is not the High Quality channel.

  • FIX: Fixes https://github.com/briis/unifiprotect/issues/428. All string enums are now case insensitive.

  • FIX: Fixes https://github.com/briis/unifiprotect/issues/427, affected cameras will automatically be converted to Detections recording mode.

Version 0.12.0-beta11

17 Jan 13:38
ac80b0c
Compare
Choose a tag to compare
Version 0.12.0-beta11 Pre-release
Pre-release

⚠️ ⚠️ WARNING ABOUT Home Assistant v2022.2

The unifiprotect integration will be in Home Assistant core v2022.2. If you are running 0.10.x or older of the HACS integration, do not install v2022.2.x of Home Assistant core.

If you are running 0.11.x or the 0.12.0-beta, you should be safe to delete the HACS version as part of your upgrade. The 0.11.x branch is designed to be compatible with the 0.12.0-beta and the HA core version. The latest version of 0.12.0-beta will be the version of unifiprotect in HA core in v2022.0.

After v2022.2.0 comes out, this repo will be deprecated in favor of the Home Assistant core version.

If you have Smart Sensor devices and you are not running 0.12.0-beta10, it is recommended you just delete your UniFi Protect integration config and re-add it. If you do not have Smart Sensor devices, you can migrate to the Home Assistant core version by following the steps below:

  1. Upgrade to the latest 0.11.x release or the latest 0.12.0-beta release for the HACS unifiprotect integration and restart Home Assistant.
  2. Upgrade to Home Assistant 2022.2.x
  3. Remove your HACS unifiprotect integration and restart Home Assistant. It is safe to ignore the warning about needing to remove your config first.

Version 0.12.0-beta10

15 Jan 00:13
36d5d28
Compare
Choose a tag to compare
Version 0.12.0-beta10 Pre-release
Pre-release

0.12.0-beta10

This is the last planned release for the HACS version. This release primarily adds new features for the G4 Doorbell Pro and the Smart Sensor. This release does unfortunatly have a couple of breaking changes for people with doorbells and Smart Sensors which are avoidable due to how soon the Home Assistant core release is.

  • CHANGE: BREAKING CHANGE The "Chime Duration" number entity has been replaced with a "Chime Type" select entity. This makes Home Assistant work the same way as UniFi Protect. (https://github.com/briis/unifiprotect/issues/451)

  • CHANGE: BREAKING CHANGE Smart Sensor support has been overhauled and improved. If you have Smart Sensors, it is highly recommended to delete your UniFi Protect integration config and re-add it. Some of the categories for the sensors have changed and it is not easy to change those without re-adding the integration. The sensors for the Smart Sensor are may also appear unavaiable if that sensor is not configured to be abled. For example, if your have motion disabled on your Sensor in UniFi Protect, the motion sensor will be unavaiable in Home Assistnat. Full list of new Smart Sensor entites:

    • Alarm Sound and Tampering binary sensors
    • Motion Sensitivity number
    • Mount Type and Paired Camera selects
    • Status Light switch
    • Configuration switches for various sensors:
      • Motion Detection switch
      • Temperature Sensor switch
      • Humidity Sensor switch
      • Light Sensor switch
      • Alarm Sound Detection switch
  • CHANGE: Adds full support for the package camera for the G4 Doorbell Pro. It should now always be enabled by default (if you are upgrading from an older version, it will still be disabled). The snapshot for the Package Camera has also been fixed. Since the camera if only 2 FPS, streaming is disabled to prevent buffering.

  • FIX: Overhaul of the Websocket code. Websocket reconnects should be drastically improved. Hopefully all reconnnect issues should be gone now.


⚠️ ⚠️ WARNING ABOUT Home Assistant v2022.2

The unifiprotect integration will be in Home Assistant core v2022.2. If you are running 0.10.x or older of the HACS integration, do not install v2022.2.x of Home Assistant core.

If you are running 0.11.x or the 0.12.0-beta, you should be safe to delete the HACS version as part of your upgrade. The 0.11.x branch is designed to be compatible with the 0.12.0-beta and the HA core version. The latest version of 0.12.0-beta will be the version of unifiprotect in HA core in v2022.0.

After v2022.2.0 comes out, this repo will be deprecated in favor of the Home Assistant core version.

If you have Smart Sensor devices and you are not running 0.12.0-beta10, it is recommended you just delete your UniFi Protect integration config and re-add it. If you do not have Smart Sensor devices, you can migrate to the Home Assistant core version by following the steps below:

  1. Upgrade to the latest 0.11.x release or the latest 0.12.0-beta release for the HACS unifiprotect integration and restart Home Assistant.
  2. Upgrade to Home Assistant 2022.2.x
  3. Remove your HACS unifiprotect integration and restart Home Assistant. It is safe to ignore the warning about needing to remove your config first.

Version 0.12.0-beta9

12 Jan 15:58
70b8d71
Compare
Choose a tag to compare
Version 0.12.0-beta9 Pre-release
Pre-release

Home Assistant core port complete! The version that is in 2022.2 will officially have all of the same features. This is the final backport version to make sure the two versions are equal. The only difference between 0.12.0-beta9 and the code in 2022.2 is

  • Migration code from < 0.11.x has been dropped. You must be on at least 0.11.0 or newer to migrate to the Home Assistant core version.

Additionally, we could not add every feature from the HACS version to the HA core version so there are 2 additional breaking changes in this release (sorry!):

  • CHANGE: BREAKING CHANGE Removes profile_ws and take_sample debug services. Core plans to add a more centralized way of getting debug information from an integration. This will be back in some form after that feature is added (estimate: 1-2 major core releases).

  • CHANGE: BREAKING CHANGE Removes event_thumbnail attribute and associated ThumbnailProxyView. After a lot of discussion, core does not want to add more attributes with access tokens inside of attributes. We plan to add back event thumbnails in some form again. If you would like to follow along with the dicussion, checkout the architecure dicussion for it.

  • FIX: More Websocket reconnect improvements.

Going forward, there will be some new features for the 0.12.0-beta / core version that will be developed for core version and then be backported to the HACS version. These include improvements for the G4 Doorbell Pro and the UP Sense devices.


⚠️ ⚠️ WARNING ABOUT Home Assistant v2022.2

The unifiprotect integration will be in Home Assistant core v2022.2. If you are running 0.10.x or older of the HACS integration, do not install v2022.2.x of Home Assistant core.

If you are running 0.11.x or the 0.12.0-beta, you should be safe to delete the HACS version as part of your upgrade. The 0.11.x branch is designed to be compatible with the 0.12.0-beta and the HA core version. The latest version of 0.12.0-beta will be the version of unifiprotect in HA core in v2022.0.

After v2022.2.0 comes out, this repo will be deprecated in favor of the Home Assistant core version.

Steps to migrate to the Home Assistant core version:

  1. Upgrade to the latest 0.11.x release or the latest 0.12.0-beta release for the HACS unifiprotect integration and restart Home Assistant.
  2. Upgrade to Home Assistant 2022.2.x
  3. Remove your HACS unifiprotect integration and restart Home Assistant. It is safe to ignore the warning about needing to remove your config first.

Version 0.12.0-beta8

08 Jan 03:24
578427a
Compare
Choose a tag to compare
Version 0.12.0-beta8 Pre-release
Pre-release

⚠️ ⚠️ WARNING ABOUT Home Assistant v2022.2

The unifiprotect integration will be in Home Assistant core v2022.2. If you are running 0.10.x or older of the HACS integration, do not install v2022.2.x of Home Assistant core.

If you are running 0.11.x or the 0.12.0-beta, you should be safe to delete the HACS version as part of your upgrade. The 0.11.x branch is designed to be compatible with the 0.12.0-beta and the HA core version. The latest version of 0.12.0-beta will be the version of unifiprotect in HA core in v2022.0.

After v2022.2 comes out, this repo will be deprecated in favor of the Home Assistant core version.


  • FIX: Fixes NVR memory sensor if no data is reported

  • FIX: Fixes spelling typo with Recording Capacity sensor (https://github.com/briis/unifiprotect/issues/440)

  • FIX: Fixes is_connected check for cameras

  • FIX: Adds back last_trip_time attribute to camera motion entity

Version 0.12.0-beta7

08 Jan 01:43
b1fbc24
Compare
Choose a tag to compare
Version 0.12.0-beta7 Pre-release
Pre-release

⚠️ ⚠️ WARNING ABOUT Home Assistant v2022.2

The unifiprotect integration will be in Home Assistant core v2022.2. If you are running 0.10.x or older of the HACS integration, do not install v2022.2.x of Home Assistant core.

If you are running 0.11.x or the 0.12.0-beta, you should be safe to delete the HACS version as part of your upgrade. The 0.11.x branch is designed to be compatible with the 0.12.0-beta and the HA core version. The latest version of 0.12.0-beta will be the version of unifiprotect in HA core in v2022.0.

After v2022.2 comes out, this repo will be deprecated in favor of the Home Assistant core version.


  • FIX: Improve relibility of Websocket reconnects

  • FIX: Further improves relibility of Doorbell binary_sensor

Version 0.12.0-beta6

07 Jan 00:48
699943e
Compare
Choose a tag to compare
Version 0.12.0-beta6 Pre-release
Pre-release

⚠️ ⚠️ WARNING ABOUT Home Assistant v2022.2

The unifiprotect integration will be in Home Assistant core v2022.2. If you are running 0.10.x or older of the HACS integration, do not install v2022.2.x of Home Assistant core.

If you are running 0.11.x or the 0.12.0-beta, you should be safe to delete the HACS version as part of your upgrade. The 0.11.x branch is designed to be compatible with the 0.12.0-beta and the HA core version. The latest version of 0.12.0-beta will be the version of unifiprotect in HA core in v2022.0.

After v2022.2 comes out, this repo will be deprecated in favor of the Home Assistant core version.


  • CHANGE: Switches Doorbell binary_sensor to use is_ringing attr, should great improve relaiability of the sensor

  • NEW: Adds take_sample service to help with debugging/issue reporting

  • FIX: Fixes voltage unit for doorbell voltage sensor

Backports changes from Home Assistant core merge process:

  • CHANGE: Dynamic select options for Doorbell Text

  • CHANGE: Improves names for a number of entities

  • CHANGE: Adds a bunch of extra debug logging for entity updates

Version 0.12.0-beta5

30 Dec 22:55
5619a18
Compare
Choose a tag to compare
Version 0.12.0-beta5 Pre-release
Pre-release

⚠️ ⚠️ WARNING ABOUT Home Assistant v2022.2

The unifiprotect integration will be in Home Assistant core v2022.2. If you are running 0.10.x or older of the HACS integration, do not install v2022.2.x of Home Assistant core.

If you are running 0.11.x or the 0.12.0-beta, you should be safe to delete the HACS version as part of your upgrade. The 0.11.x branch is designed to be compatible with the 0.12.0-beta and the HA core version. The latest version of 0.12.0-beta will be the version of unifiprotect in HA core in v2022.0.

After v2022.2 comes out, this repo will be deprecated in favor of the Home Assistant core version.


The 0.12.0-beta is designed to be a "beta only" release. There will not be a stable release for it. It is designed to test the final changes needed to merge the unifiprotect into Home Assistant core.

Version 0.12.0-beta4

30 Dec 21:22
074dfe1
Compare
Choose a tag to compare
Version 0.12.0-beta4 Pre-release
Pre-release

⚠️ ⚠️ WARNING ABOUT Home Assistant v2022.2

The unifiprotect integration will be in Home Assistant core v2022.2. If you are running 0.10.x or older of the HACS integration, do not install v2022.2.x of Home Assistant core.

If you are running 0.11.x or the 0.12.0-beta, you should be safe to delete the HACS version as part of your upgrade. The 0.11.x branch is designed to be compatible with the 0.12.0-beta and the HA core version. The latest version of 0.12.0-beta will be the version of unifiprotect in HA core in v2022.0.

After v2022.2 comes out, this repo will be deprecated in favor of the Home Assistant core version.


The 0.12.0-beta is designed to be a "beta only" release. There will not be a stable release for it. It is designed to test the final changes needed to merge the unifiprotect into Home Assistant core.

Backports fixes from Home Assistant core merge process:

  • FIX: Improves relibility of entities when UniFi Protect goes offline and/or a device goes offline. Everything recovery seemlessly when UniFi Protect upgrades or firmware updates are applied (fixes https://github.com/briis/unifiprotect/issues/432).

  • FIX: Improves relibility of media_player entities so they should report state better and be able to play longer audio clips.

  • FIX: Fixes stopping in progress audio for media_player entities.

  • FIX: Allows DNS hosts in addition to IP addresses (fixes https://github.com/briis/unifiprotect/issues/431).

  • FIX: Fixes selection of default camera entity for when it is not the High Quality channel.

Version 0.12.0-beta3

25 Dec 19:38
b1c9d50
Compare
Choose a tag to compare
Version 0.12.0-beta3 Pre-release
Pre-release

⚠️ ⚠️ WARNING ABOUT Home Assistant v2022.2

The unifiprotect integration will be in Home Assistant core v2022.2. If you are running 0.10.x or older of the HACS integration, do not install v2022.2.x of Home Assistant core.

If you are running 0.11.x or the 0.12.0-beta, you should be safe to delete the HACS version as part of your upgrade. The 0.11.x branch is designed to be compatible with the 0.12.0-beta and the HA core version. The latest version of 0.12.0-beta will be the version of unifiprotect in HA core in v2022.0.

After v2022.2 comes out, this repo will be deprecated in favor of the Home Assistant core version.