Beta docs for this release: https://deploy-preview-6262--frigate-docs.netlify.app
Major Changes For 0.13.0
Changes since Beta 1
- Revert min_region_size that resulted in new false positives for some users
- Improve object tracking behavior to fix disjointed events in some cases
- Exports page now supports playback and deleting exports
- Reduce CPU usage for exports and add configuration option for time-lapse video filter output args
- Support selecting which Nvidia GPU is used to build TensorRT model in case multiple are present
- Update go2rtc to 1.7.1
Breaking Changes
- Default values have been changed for motion detection. If you have specific values set in your config, it is recommended to remove them and re-calibrate as necessary.
- Changes have been made to the DB schema, downgrading to 0.12 will require restoring from a backup or deleting the DB and existing recordings / snapshots.
NOTE: Some users have reported migrations taking a while and frigate frontend is not available until the migrations are complete. - New location for
frigate.db
: Due to the support for network shares in HA OS and the popularity of storing recordings on a NAS in general, the database has a new default location of/config/frigate.db
. This change is going to be done for existing users too, so frigate will automatically move the db for you.-
For Frigate Addon Users:
The migration is handled automatically and no action is required from the user. -
For Docker Container Users:
The migration is handled for you, but you must make sure that the docker CLI or docker-compose binds the entire/config
directory and not just the/config/config.yml
file.For example, if your current volume mapping is
- /host/path/config_folder/config.yml:/config/config.yml
it should now be- /host/path/config_folder/:/config/
-
- The previously deprecated
record -> retain_days
config has been removed, this should be migrated torecord -> retain -> days
if you have not already. - HomeAssistant Integration 5.0 beta is required for the new features introduced in this release.
- TensorRT has been updated and the model generation has been refactored. New models will need to be generated for 0.13 and have a new path, check the detector docs for more info.
- TensorRT now requires Nvidia Driver Version 530+
Frigate+
Frigate+ Model Launch
Frigate+ models are now rolling out by invitation. If you would like to be invited for early access to purchase a subscription, please send an email to blake@frigate.video from the email address on your Frigate+ account. For more information, see this discussion.
False positive submissions
You can now submit false positive detections to Frigate+ for training feedback. Note that you will still need to login to your Frigate+ account and verify the images to ensure all relevant objects are labeled before the image will be used during training. Confirming the object is a true positive will also upload the image.
Models
Frigate+ models are almost ready for launch, and this release has support for automatically downloading from Frigate+. The model and related information are stored at /config/model_cache
. Once Frigate+ models are launched, you will be able to use the model id in your config.
model:
path: plus://e63b7345cc83a84ed79dedfc99c16616
Community Supported Boards
In version 0.12 Frigate gained support for Intel iGPUs via OpenVINO and for Nvidia GPUs, this was a great step forward for compatibility and for more users being able to use Frigate effectively. There are many other devices, including dedicated SBCs (Small Board Computers), that Frigate could support but the maintainers do not have the time or hardware to support.
The community supported boards framework will allow community members who want to contribute to create and manage support for a particular board. This will allow Frigate to support more devices while allowing the maintainers to focus on improving the core of Frigate.
Nvidia Jetson Support
@madsciencetist is the first to contribute a community supported board build by adding support for Jetson 4.6 and Jetson 5 devices!
More information can be found in the detector docs on how to set this up.
Object Tracking & Motion Detection
There have been many improvements to object tracking and motion detection which make Frigate more efficient and can reduce false positives.
New Object Tracker
Frigate now uses Norfair for object tracking, this means that object attributes like size, width/height ratio, and position are used to intelligently track objects. ID swapping between tracked objects is greatly reduced in situations where a car in the driveway was confused with a car passing in the street.
Improved Motion Detection
Frigate's motion detection is now more efficient. Motion detection will also re-calibrate for flashes like lightning or when the camera switches from color to IR mode or it is moved via PTZ. This reduces CPU usage during these changes and reduces false positives caused by excessive motion.
Minimum Time For Zone Presence
Frigate now has a configurable field for the minimum amount of time an object needs to be in a zone before it is considered in a zone. For example, currently in Frigate if you have a front_yard zone and someone is walking by and briefly steps into the front yard Frigate would create an event for this. However, you may prefer for events to only be created if a person is in the front yard for multiple frames before creating an event.
zones:
my_zone:
inertia: 3 # <- 3 consecutive frames needed to consider object in zone
coordinates: ...
Recordings Improvements
There have been a number of improvements to the management of recordings
Recordings Exporting
Frigate now supports exporting recordings in standard format or as a time-lapse. Exported recordings are stored in /media/frigate/exports
and are downloadable from the UI.
Recordings Timeline Metadata
Frigate now saves metadata for key moments in an event such as when the tracked object is detected, enters or exits zone, becomes active / stationary, and leaves. This metadata is used to overlay on top of the recordings so it is easy to see what was detected and where. Note that the timing of the bounding boxes will likely be slightly off because it is based on the detect stream, but overlayed on the record stream. The annotation_offset
value in the config can be used to adjust for any differences.
Internal Processing Improvements
There have been many improvements to the recordings management process to make it faster and more efficient:
- Recordings maintainer now lives in a dedicated process
- Recordings maintenance is now fully asynchronous
- Database writes are now much more efficient
- Record config can now have
sync_on_startup
enabled which will check for recordings in the db that are not on the disk and delete them
Audio Events
Frigate now supports audio events via YamNet. Over 600 labels are included so there are too many to list here, but Frigate can listen to a cameras audio feed to create events and update MQTT when speech, yell, fire alarm, dog bark, etc. are heard. Version 5.0 of the HomeAssistant integration also supports sensors for these audio detections so automations can be fired when certain types of audio are detected.
Manual Events API
Frigate now supports creating events manually via the API. This means that custom events can be created, for example an event when the doorbell is pressed or a sensor is tripped. The API allows full control of event length, if recordings should be saved, and much more. The request and response can be seen in the documentation.
Curl Example:
curl -X POST "http://<frigate_ip>:5000/api/events/front_doorbell_cam/doorbell/create" -H Content-Type:\ application/json
PTZ Control
Frigate now supports PTZ cameras.
Basic PTZ Autotracking
https://deploy-preview-6262--frigate-docs.netlify.app/configuration/autotracking
Along with Frigate's improved tracking algorithm, basic autotracking is now supported. Not all PTZ cameras will support this as relative movement is required (see the docs for more details).
PTZ Controls In The WebUI
Frigate also supports controlling PTZ cameras in the WebUI and via the Home Assistant Integration.
Other Notable Changes:
- The ordering of birdseye cameras is now supported
- Birdseye now supports autolayout meaning that a grid system is no longer used. Panoramic and portrait cameras now take up a proportional amount of space to better use the canvas to show these cameras.
- Camera zone & mask editor now supports saving directly without the need to copy / paste
- Deepstack/CodeProjectAI is now supported as a detector.
Images
ghcr.io/blakeblackshear/frigate:0.13.0-beta2
ghcr.io/blakeblackshear/frigate:0.13.0-beta2-standard-arm64
ghcr.io/blakeblackshear/frigate:0.13.0-beta2-tensorrt
ghcr.io/blakeblackshear/frigate:0.13.0-beta2-tensorrt-jp4
ghcr.io/blakeblackshear/frigate:0.13.0-beta2-tensorrt-jp5
All changes since Beta 1
- Fix webUI success / error messages by @NickM-27 in #7820
- Remove quotes from tensorrt env variable example by @NickM-27 in #7823
- Remove maximum inertia constraint by @NickM-27 in #7890
- Add ability to play and delete exports from webUI by @NickM-27 in #7882
- revert min region size by @NickM-27 in #7883
- Remove frame interval for qsv timelapse output args by @NickM-27 in #7873
- Fix birdseye exception handling by @NickM-27 in #7864
- Set export sub process to be lower priority by @NickM-27 in #7862
- Add fire alarm to default audio labels by @NickM-27 in #7854
- Select a specific GPU for converting TRT models by @NateMeyer in #7857
- Add cancel button to delete starred event dialog by @NickM-27 in #7853
- Refactor Exports To Better Handle Recording Configs by @NickM-27 in #7846
- use useEffect for key listeners on camera control panel by @hawkeye217 in #7827
- add note about network bandwidth permissions and don't set interfaces by default by @NickM-27 in #7813
- Add docs for audio volume config by @NickM-27 in #7807
- Add capability to link directly to an event ID in the web UI by @hoverduck in #7803
- Improve default timelapse args and make timelapse customizable by @NickM-27 in #7840
- Update go2rtc to 1.7.1 by @NickM-27 in #7657
- fix typo by @NickM-27 in #7903
- add more robust plus documentation by @blakeblackshear in #7905
- Fix case where camera is disabled but autotrack is enabled by @NickM-27 in #7914
- Increase initial hit count for norfair tracker by @NickM-27 in #7925
New Contributors
- @hoverduck made their first contribution in #7803
Full Changelog: v0.13.0-beta1...v0.13.0-beta2