homebridge-unifi-protect
Complete HomeKit integration for all UniFi Protect device types with full support for most features including HomeKit Secure Video, and more. https://homebridge.io
OTHER License
Ecosystems:
Homebridge,
Framer Motion
Bot releases are visible (Hide)
homebridge-unifi-protect
- v4.3.0
Published by hjdhjd almost 4 years ago
4.3.0 (2020-12-26)
- Removed support for legacy UniFi Cloud Key Gen2+ firmware.
homebridge-unifi-protectnow requires at least firmware version 2.0.24 or newer, which adds full UniFi OS support for UCK Gen2+ devices. This may be a breaking change if you aren't on the latest stable firmware for UCK Gen2+.
homebridge-unifi-protect
- v4.2.0
Published by hjdhjd almost 4 years ago
4.2.0 (2020-11-26)
- New feature: video transcoding. This feature option should not be needed for most people. For the unlucky few that struggle with getting native streaming to work, please refer to the troubleshooting documentation for how and when to use this feature, and it's implications.
- Dependency and library updates.
homebridge-unifi-protect
- v4.1.5
Published by hjdhjd almost 4 years ago
4.1.5 (2020-11-22)
- Fix for a regression of MQTT event triggers.
- Increase API timeout limit to give WiFi-based cameras a little more time to respond.
- Dependency and library updates.
homebridge-unifi-protect
- v4.1.4
Published by hjdhjd almost 4 years ago
4.1.4 (2020-11-09)
- Reinstate compatibility with NodeJS 12.
homebridge-unifi-protect
- v4.1.3
Published by hjdhjd almost 4 years ago
4.1.3 (2020-11-08)
- More minor housekeeping and documentation updates.
homebridge-unifi-protect
- v4.1.2
Published by hjdhjd almost 4 years ago
4.1.2 (2020-11-08)
- Minor housekeeping and documentation updates.
homebridge-unifi-protect
- v4.1.1
Published by hjdhjd almost 4 years ago
4.1.1 (2020-11-08)
- Fix: ensure that
homebridge-unifi-protecthonors RTSP streaming feature option scope for individual HomeKit clients.
homebridge-unifi-protect
- v4.1.0
Published by hjdhjd almost 4 years ago
4.1.0 (2020-11-07)
- Enhancement: feature options can now be specified on a per-client basis for audio and video feature options. For example, you can now specify that a specific RTSP profile be used with a specific client IP address (e.g. Apple TV). This can be useful in situations where you really want to control exactly which RTSP profile is used for a particular HomeKit client. An example of this that is immediately useful to some people: if you use
Enable.Video.Stream.Only.Lowbecause of trouble streaming remotely (outside of your home), you can now override it when you are home withEnable.Video.Stream.Only.X.IPADDRESS, where X is Medium or High, and IPADDRESS represents the static IP address of your iPhone. In this example, when remote, video streaming will always use the Low RTSP profile, but when at home, video streaming will use X.
homebridge-unifi-protect
- v4.0.1
Published by hjdhjd almost 4 years ago
4.0.1 (2020-11-03)
- Fix for a regression related to event detection on non-UniFi OS platforms.
- Fix for a race condition related to adding newly detected Protect devices -
homebridge-unifi-protectwill wait until they are finsihed being adopted by the Protect controller before adding the device to HomeKit.
homebridge-unifi-protect
- v4.0.0
Published by hjdhjd almost 4 years ago
4.0.0 (2020-11-01)
- IMPORTANT BREAKING CHANGE: many of the feature options have had their names change (mostly minor changes) in order to create clear namespaces and provide more consistency throughout the plugin. As feature options have grown over time, I took a step back and wanted to rethink how to logically structure feature options and prepare for the future. Refer to the feature options documentation for the complete reference, and update your feature options before you restart Homebridge.
- New feature option:
Audio. This will allow you to enable or disable audio support for cameras. - New feature option:
Doorbell.Trigger. This feature has a dual purpose:- First, for Protect cameras that are not hardware doorbells, this will allow you to enable or disable HomeKit doorbell support on any Protect camera.
- Second, this will create a switch accessory in HomeKit that you can use to manage automations - you can use it to trigger a doorbell ring, and the switch will turn on or off when a genuine ring occurs on Protect hardware doorbells.
-
Breaking change: The
ContactSensorfeature option for Protect doorbells has been deprecated and removed in favor of the newDoorbell.Triggerfeature option, which provides this functionality and more. - New feature option:
Motion.SmartDetect. This feature option takes advantage of new smart detection capabilities in Protect controller v1.15 and above for for G4 series cameras only (that's a Protect limitation, not a limitation ofhomebridge-unifi-protect). Smart detection is Protect's name for AI/ML-based object detection for motion events. Currently, Protect can detect people, but I expect more object types to be added in the future, andhomebridge-unifi-protectwill support them when they do. This feature option allows you to use Protect's smart object detection to decide whether to notify you of a motion event or not. What does this mean to you? If you only want to see a motion event when Protect detects an actual person rather than some leaves blowing across the camera, this is the feature you've been waiting for. This feature is only available for UniFi OS-based Protect controllers - UCKgen2+ controllers aren't currently supported. I plan to add support for this feature on UCKgen2+ in the future. Read the feature options documentation for more information. - Enhancement: video stream selection has been redesigned and improved. We now match the resolution requested by HomeKit against the list of available RTSP streams from the Protect camera to provide a richer experience. This should result in improved compatibility across a broader range of resolutions across the Apple ecosystem (iOS, iPadOS, macOS, tvOS, watchOS). Oh...it also includes support for 4K resolutions which it seems that HomeKit is beginning to add support for (though not officially in the HomeKit spec yet).
- Enhancement: improve overall responsiveness by enforcing time limits on the Protect API. You will see more errors and alerts in the logs related to the controller API. They can largely be ignored. Protect controllers are occasionally very slow to respond, taking 5+ seconds to return an API call. We now aggressively terminate those calls in order to not slow down HomeKit / Homebridge responsiveness overall. For the most part, these error messages can be safely ignored and
homebridge-unifi-protectwill handle them gracefully. - Enhancement: when
homebridge-unifi-protectis unable to retrieve a snapshot from the controller, it will attempt to use the most recent snapshot from that camera, if that snapshot is less than 60 seconds old. - Enhancement: improve startup times by better utilizing the Homebridge object cache.
- Enhancement: increase responsiveness of LCD messages using the realtime events API on UniFi OS-based controllers.
homebridge-unifi-protect
- v3.7.9
Published by hjdhjd about 4 years ago
3.7.9 (2020-10-10)
- Housekeeping updates and minor optimizations.
homebridge-unifi-protect
- v3.7.8
Published by hjdhjd about 4 years ago
3.7.8 (2020-10-02)
- Enhancement: streamlined handling when Protect devices become unavailable.
- Fix: workaround a limitation in Homebridge where it doesn't notify us of a video stream disappearing. This will hopefully be addressed in a future Homebridge release.
homebridge-unifi-protect
- v3.7.7
Published by hjdhjd about 4 years ago
3.7.7 (2020-09-27)
- Fix: Redact MQTT password information in Homebridge logs.
homebridge-unifi-protect
- v3.7.6
Published by hjdhjd about 4 years ago
3.7.6 (2020-09-22)
- Housekeeping updates and minor optimizations.
homebridge-unifi-protect
- v3.7.5
Published by hjdhjd about 4 years ago
3.7.5 (2020-09-18)
- Housekeeping fixes.
homebridge-unifi-protect
- v3.7.4
Published by hjdhjd about 4 years ago
3.7.4 (2020-09-16)
- Housekeeping fixes.
homebridge-unifi-protect
- v3.7.3
Published by hjdhjd about 4 years ago
3.7.3 (2020-09-16)
- Fix: Really fix that pesky logging regression.
homebridge-unifi-protect
- v3.7.2
Published by hjdhjd about 4 years ago
3.7.2 (2020-09-16)
- Fix: Really fix that pesky logging regression.
homebridge-unifi-protect
- v3.7.1
Published by hjdhjd about 4 years ago
3.7.1 (2020-09-16)
- Fix: Small regression related to logging.
homebridge-unifi-protect
- v3.7.0
Published by hjdhjd about 4 years ago
3.7.0 (2020-09-15)
- New feature: noise filters. Read the documentation and the associated feature options
- Enhancement: improved device detection support in anticipation of more types of UniFi Protect cameras in the future.
- Enhancement: support for self-signed TLS certificates for those with MQTT brokers.
- New behavior: motion switches for each camera are now disabled by default. To better understand why, please read homebridge-unifi-protect best practices for more information. Motion detection remains on by default, of course. Fear not, you can still get them back by default if you want - just set the feature option
Enable.MotionSwitcheither globally, or per-camera. - New behavior: motion and doorbell events are not logged by default. This goes along with the above to reduce unnecessary logging. If you're like to restore the previous behavior, just set the feature option
Enable.LogMotionandEnable.LogDoorbelleither globally, or per-camera. You can read more about homebridge-unifi-protect best practices to understand why the defaults were changed. - Various housekeeping improvements.
Package Rankings
Top 8.05% on Npmjs.org
Badges
Extracted from project README
