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
- v7.3.1
Published by hjdhjd about 1 month ago
7.3.1 (2024-09-15)
- Housekeeping.
homebridge-unifi-protect
- v7.3.0
Published by hjdhjd about 1 month ago
7.3.0 (2024-09-15)
- New feature: Protect chimes now support all ringtones available, including custom ones. a switch will be created for each ringtone available.
- Improvement: improve performance on lower powered environments like Pi4.
- Housekeeping.
homebridge-unifi-protect
- v7.2.0
Published by hjdhjd about 1 month ago
7.2.0 (2024-09-14)
- Behavior change: API livestreaming is now the default. You can revert to the former method, using RTSP streams if you prefer. I intend to deprecate RTSP streaming at some future point.
- Behavior change: The timeshift buffer is now mandatory in HBUP for HKSV. Latency issues make the legacy RTSP method extremely unreliable and I've decided to simplify and focus on a great HKSV experience at the expense of supporting low-power/limited CPU environments.
- Removed feature: The HKSV maximum recording duration feature option has been removed. With recent changes to the Protect API make this extremely unreliable.
- New feature: on Protect cameras that support it, an ambient light sensor will be added, reporting the current light level.
- New feature: for automation use cases, an optional switch can be enabled to control the status indicator light on Protect devices that support it. This feature is supported on all UniFi Protect device types that have a status indicator light (currently cameras, lights, and sensors) Find it under device feature options. Disabled by default.
- New feature: the status indicator light on Protect cameras can be used to automatically reflect when an HKSV event is being recorded. With this enabled, the status indicator light will switch on when an event is being actively recorded and off once it stops. Find it under HKSV feature options. Disabled by default. Thanks to @kevinwestby for the suggestion and enhancement request.
- Improvement: further refinements to API livestreaming and HKSV.
- Improvement: Protect-based smart motion detection (not to be confused with HKSV) has been refined to support the changes introduced by Ubiquiti in Protect firmware 4.1 and beyond. HBUP now requires v4.1 or later, as of this release, as a result. As a reminder, non-GA/official firmware releases are explicitly unsupported by HBUP.
- Housekeeping and refinements. Lots of them...subtle and not.
homebridge-unifi-protect
- v7.1.2
Published by hjdhjd 4 months ago
7.1.2 (2024-06-16)
- Improvement: additional refinements to API livestreaming.
- Housekeeping.
homebridge-unifi-protect
- v7.1.1
Published by hjdhjd 4 months ago
7.1.1 (2024-06-15)
- Improvement: some further refinements to HKSV recording.
homebridge-unifi-protect
- v7.1.0
Published by hjdhjd 4 months ago
7.1.0 (2024-06-15)
- Behavior change: transcoding is now enabled by default even for local/low-latency streaming. The reason for this change is that HomeKit really doesn't provide a good distinction between local versus remote streaming, merely hinting at whether a HomeKit client is in a low-latency or high-latency environment. If you're on WiFi in a remote location and accessing your Protect cameras in the Home app, they would appear to HomeKit and HBUP as a low-latency connection rather. I believe these defaults are more sane and consistent as we move into the next generation of HBUP and Protect. You can, as always, adjust the defaults.
- Improvement: hardware-accelerated decoding has been reenabled for HKSV. I disabled this quite some time ago as it seemed to be finicky at times and lead to unnecessary recording errors, but things seem to have improvement somewhat on the Protect end of things and I've also added some safety checks to alleviate the issues. The benefits outweigh the potential downsides, particularly given how often HKSV events can be triggered in most environments.
- Improvement: further optimizations to snapshots to ensure we're even more responsive to HomeKit. HBUP now goes to more lengths to guarantee a short response time to snapshot requests by the Home app.
- Improvement: further optimizations and refinements of API-based livestreaming. I'm hoping to evolve this to be the default in future releases, but there's a little more testing and work I'd like to do first. Using API livestreaming has numerous advantages including substantially lower resource utilization on the Protect controller itself if you're already using HKSV and have timeshifting enabled (which it is by default). In addition, livestreams are now essentially instantaneous across the board, and more is coming. TL;DR: things are faster, better, and more streamlined...and still experimental.
- Improvement: HEVC (aka enhanced encoding in Protect-speak) based recording events are much better supported with far fewer grey/blank event snapshots in the HKSV timeline than in prior releases.
homebridge-unifi-protect
- v7.0.7
Published by hjdhjd 4 months ago
7.0.7 (2024-06-10)
- Housekeeping.
homebridge-unifi-protect
- v7.0.6
Published by hjdhjd 4 months ago
7.0.6 (2024-06-10)
- Breaking change: due to changes in the Protect controller, and my desire to continue to move forward rather than expend too much energy looking back, HBUP v7+ now requires Protect controller v4.0 or better.
- Improvement: further refinements to API livestreaming.
- Housekeeping.
homebridge-unifi-protect
- v7.0.5
Published by hjdhjd 4 months ago
7.0.5 (2024-06-09)
- Fix: address a regression with pre-Protect 4.0-based controllers.
- Housekeeping.
homebridge-unifi-protect
- v7.0.4
Published by hjdhjd 4 months ago
7.0.4 (2024-06-09)
- Improvement: more refinements to API livestreaming.
- Housekeeping.
7.0.3 (2024-06-09)
- Housekeeping.
homebridge-unifi-protect
- v7.0.2
Published by hjdhjd 4 months ago
7.0.2 (2024-06-09)
- Improvement: more refinements to API livestreaming.
- Housekeeping.
homebridge-unifi-protect
- v7.0.1
Published by hjdhjd 5 months ago
7.0.1 (2024-06-06)
- Fix: addressed a regression in the first run webUI.
- Improvement: refinements to accessing the Protect Livestream API when livestreaming from the Home app. Certain camera types (notably the AI Pro and G4 Pro) will not livestream certain quality levels due to regressions in the current Protect controller firmware. I've implemented a workaround for the time being that forces the use of the high quality stream with those cameras. Let's see how it goes...Note: this is an experimental feature and I will accept no support requests related to it. You're on your own if you have an issue.
- Housekeeping.
homebridge-unifi-protect
- v7.0.0
Published by hjdhjd 5 months ago
7.0.0 (2024-06-03)
- New feature: experimental support for using the Protect livestream API directly when livestreaming in the Home app. This will provide an instantaneous livestreaming experience, but it has some caveats that I'm continuing to work through. At some point it may become the default - for now, if you want to enable this feature, you'll need to do so through the feature options webUI under the video options section. Note: this is an experimental feature and I will accept no support requests related to it. You're on your own if you have an issue.
- Breaking change: default doorbell messages are no longer supported as of Protect controller firmware 4.0. That functionality has been removed from HBUP. To accomplish the same thing, just set a message with an indefinite duration either in HBUP, or through the Protect controller webUI (or native Protect app).
- Breaking change: dynamic bitrate support has been removed. This was always an esoteric and often misunderstood feature, and generally didn't do a great job of solving the problem it was meant to solve. In the era of HEVC on Protect, it makes even less sense now given the need to transcode in most circumstances.
- Improvement: if you're using the Protect enhanced encoding (which enables H.265/HEVC as the video codec Protect uses rather than H.264) setting on your cameras, HBUP will detect this and transcode even if you've requested that it not do so. HomeKit does not currently support anything other than H.264.
- Improvement: the HBUP webUI has been further refined. Nobody might notice but me, but it still makes me smile.
- Housekeeping: some significant spring cleaning and standardization.
homebridge-unifi-protect
- v6.22.0
Published by hjdhjd 6 months ago
6.22.0 (2024-04-27)
- New feature: you can now choose to override the bitrates HomeKit requests (either locally or remotely). This allows you to have a much higher quality transcoding experience at home or remotely.
- Housekeeping.
homebridge-unifi-protect
- v6.21.1
Published by hjdhjd 6 months ago
6.21.1 (2024-04-21)
- Fix: ensure we honor user-selected stream quality defaults.
homebridge-unifi-protect
- v6.21.0
Published by hjdhjd 6 months ago
6.21.0 (2024-04-21)
- Improvement: even faster startup times for livestreams.
- Improvement: I've adjusted the defaults when transmuxing to better align to HomeKit expectations and certain Apple quirks. This should particularly result in improvements to the default experience on tvOS.
- Improvement: more robust handling of misbehaving Protect controllers. HBUP will more assertively disconnect and reconnect from the Protect controller when too many transcoding errors are encountered.
- Improvement: additional smart object detection options are now available through the HBUP webUI.
- Improvement: documentation updates.
- Fix: events from Protect sensors are once more published to MQTT immediately.
- Housekeeping.
homebridge-unifi-protect
- v6.20.0
Published by hjdhjd 7 months ago
6.20.0 (2024-03-30)
- New feature: UniFi chime devices now expose two additional switches, allowing you to trigger the chime speaker with either the default tone or the buzzer tone. Buzzer tone you say, what's that? Give it a try.
- New feature: The new high quality (and performance) snapshot capabilities can now be controlled through a feature option. The option is enabled by default, but can be disabled if you prefer. Why might you want to disable it? In certain performance-constrained environments (e.g. Pi), snapshots may take longer to generate than HomeKit allows for when the CPU is under heavier load.
- Change: HomeKit Secure Video events are no longer logged by default. You can enable HKSV event logging using the appropriate feature option through the webUI.
- Breaking changes for MQTT users: MQTT capabilities have been standardized - see the MQTT documentation for details. The changes are focused on streamlining how you can query HBUP, and how information is published. In addition, all the MQTT capabilities are now documented. A few items weren't previously.
- Housekeeping, spring cleaning, and a few refinements throughout.
homebridge-unifi-protect
- v6.19.0
Published by hjdhjd 7 months ago
6.19.0 (2024-03-17)
- New feature: add support for optionally choosing to make Protect devices standalone in HomeKit. If you choose to do so, you'll have to manually manage the individual Protect devices in HomeKit. I would not recommend using this feature for most people.
- Improvement: snapshots have been rethought and optimized, and image quality has been significantly improved. In recent Protect controller firmware releases, the Protect API no longer produces high-quality snapshots and the performance of the Protect controller has been inconsistent at best. With this release, snapshots are now first driven from the timeshift buffer, for those that have enabled HKSV and timeshifting. If that's not available or unusable, HBUP will snapshot the RTSP stream to the controller before trying the Protect API as a final fallback.
- Housekeeping.
homebridge-unifi-protect
- v6.18.1
Published by hjdhjd 8 months ago
6.18.1 (2024-03-01)
- Housekeeping.
Package Rankings
Top 8.05% on Npmjs.org
Badges
Extracted from project README
