Skip to content

0.14.0 Beta 1

Pre-release
Pre-release
Compare
Choose a tag to compare
@blakeblackshear blakeblackshear released this 25 May 17:16
· 753 commits to dev since this release

Beta Documentation: https://deploy-preview-11419--frigate-docs.netlify.app/

Images

  • ghcr.io/blakeblackshear/frigate:0.14.0-beta1
  • ghcr.io/blakeblackshear/frigate:0.14.0-beta1-standard-arm64
  • ghcr.io/blakeblackshear/frigate:0.14.0-beta1-tensorrt
  • ghcr.io/blakeblackshear/frigate:0.14.0-beta1-tensorrt-jp4
  • ghcr.io/blakeblackshear/frigate:0.14.0-beta1-tensorrt-jp5
  • ghcr.io/blakeblackshear/frigate:0.14.0-beta1-rk

Major Changes for 0.14.0

Breaking Changes

There are several breaking changes in this release, so a backup of your current config and database is recommended before upgrading:

  • Simply copy your current config file to a new location
  • Stop Frigate and make a copy of the frigate.db file

Your existing events will not be visible in Frigate's new UI

  • An entirely new way of reviewing camera footage has been implemented in Frigate 0.14, and existing events could not be migrated
  • Recordings can still be viewed in the new UI using the recordings viewer (From Live view, click/tap on a camera and select the History button at the top left)
  • You may want to export any starred/favorite events before upgrading
  • If you are using the Home Assistant integration, events can still be viewed there

Zone/mask coordinates are now stored in the config as relative values

  • Frigate's configuration migrator will read your existing mask/zone coordinates and convert them for relative use internally on startup
  • After these changes, your config file will be incompatible with the prior version
  • If you have mask/zone coordinate values that exceed the detect resolution, it will be ignored and you will see warnings in the log. Delete the mask or zone from your config and then use the editor in the UI to recreate it.

Backwards incompatible database changes

  • There are a number of changes made to Frigate's database, which are not backwards compatible. A backup of the database is automatically made on startup, but a manual backup is highly recommended.

Brand New UI

Frigate 0.14's UI has been completely rewritten (guided demo) and optimized for desktop and mobile devices, aiming to simplify the user experience by focusing on two specific goals:

  1. Allow you to quickly see what's currently happening or what just happened on your cameras. The new Live view features a real-time dashboard with live camera feeds and a filmstrip of animated thumbnails showing recent activity.
  2. Make reviewing video footage more efficient. Frigate intelligently identifies parts of your timeline for review by leveraging the underlying data about motion and tracked objects. The new Review area implements a scrollable grid of thumbnails alongside a timeline where a hover or swipe begins a preview playback. Review items can be configured to be pre-categorized into alerts or detections based on cameras and/or zones. The review area also provides a motion review mode, allowing real-time scrubbing of video footage for any objects of interest that Frigate may have missed.

Frigate 0.14's UI will likely change the way you review your camera footage. It's a big change, but we love it and hope you do too. See the announcement post for more information regarding the motivation, ideas, and design decisions behind the new UI.

Dashboard

The new home page for Frigate is intended to be a real-time dashboard for your cameras. Recent alerts are represented by animated thumbnails in a filmstrip view above your camera feeds. Your camera images update once per minute when no detectable activity is occurring to conserve bandwidth and resources. As soon as any motion is detected, cameras seamlessly switch to a full-resolution live stream.

  • Custom camera groups are now supported. Add any of your cameras (including the Birdseye camera) to user-definable groups and easily toggle between them.
  • On desktops and tablets, cameras in a camera group can be resized and rearranged via dragging.

Screen Shot 2024-05-18 at 18 00 22 PM

Live View

Clicking a camera from the dashboard will bring up a full-resolution live view where you can quickly access historical footage, use PTZ controls, toggle camera audio, use two-way talk, and more. Zooming with pinch or a scroll wheel is also supported.

Screen Shot 2024-05-18 at 18 02 30 PM

Review

The Review area of Frigate 0.14 is for quickly reviewing historical footage of interest from your cameras. Review items are indicated on a vertical timeline and displayed as a grid of previews - bandwidth-optimized, low frame rate, low resolution videos. Hovering over or swiping a preview plays the video and marks it as reviewed. If more in-depth analysis is required, the preview can be clicked/tapped and the full frame rate, full resolution recording is displayed. Review items are filterable by date, object type, and camera.

Screen Shot 2024-05-18 at 18 01 12 PM

Alerts and Detections

Not every segment of video captured by Frigate may be of the same level of interest to you. Video of people who enter your property are a different priority than those walking by on the sidewalk. For this reason, Frigate 0.14 categorizes review items as alerts and detections. By default, all person and car objects are considered alerts. You can refine categorization of your review items by configuring required zones for them.

See the review docs for more information

Motion review

In Frigate 0.13, there isn’t a way to see motion activity on a timeline and watch video at that time. The ability to scrub video for things Frigate missed has been one of the most common feature requests. Within the Motion tab of the Review section, you can now scrub through the timeline for all cameras simultaneously with a timeline showing relative motion activity. In order to avoid scrubbing over time periods already included in alerts and detections, you can also scrub in motion only mode.

image

History

In Frigate 0.14, full frame rate, full resolution camera footage (called "recordings" in earlier versions) can be viewed and scrubbed via a timeline. Previews of your other cameras are displayed and scrubbed alongside the main selected camera.

  • Exporting footage from the History view has been drastically improved. Choose predefined time periods, enter a time directly, or drag handles on the timeline to select an export range.
  • Past exports can be viewed, renamed, deleted, and downloaded from the dedicated Export pane, accessible from the navigation bar.

Other Notable UI Changes

  • System stats - New charts and graphs with colored segments to track system usage history and more quickly identify problems or issues.
  • Status bar - A new status bar gives at-a-glance CPU/GPU usage as well as any problems or issues with Frigate.
  • New log viewer - The log viewer now provides a pane with links to solutions for common issues.
  • Real-time motion tuning - Tune motion detection settings for your cameras without editing your config file and restarting.
  • New mask and zone editor - Edit your masks and zones with a much-improved editor.

Authentication

Frigate now supports authentication with support for two different modes: native and proxy. In native mode, Frigate manages users and authentication using JWT tokens via a cookie or authorization header. Proxy mode is specifically designed to make use of common authentication proxies such as authelia, authentik, oauth2_proxy, etc.

  • Authentication is enforced on a new port 8080, and port 5000 is still unauthenticated for backwards compatibility. If you want to use Frigate's authentication, update your reverse proxy to point at port 8080 instead of 5000.
  • Support for role based authorization (admin/user roles) will come in a future release and will support upstream authentication proxies.
  • We are planning to include TLS support in 0.14.0 as well.
  • The Home Assistant integration needs to be pointed at port 5000. Some recommended configuration examples are in the updated docs.

See the documentation for more information.

Frigate+

Frigate 0.14 now offers a dedicated page for Frigate+ submissions, allowing more specific filtering by score and a faster workflow. Support has also been added to upload frames directly from the History view.

Other notable improvements

  • Loitering Time - Zones now support a loitering_time configuration which can be used to only consider an object as part of a zone if they loiter for the specified number of seconds. This can be used, for example, to create alerts for cars that stop on the street but not cars that just drive past your camera.
  • Two-way talk - For supported cameras, two-way talk can be used directly from a camera's live view.
  • PWA-optimized - The UI has been optimized to work as a progressive web app. Pin Frigate to your iOS home screen or install on Android for a full app-like experience.
  • Rockchip boards now support object detection - See the Rockchip documentation for more information.
  • Automatic hardware acceleration - automatic detection and configuration of hardware acceleration for ffmpeg is attempted on startup
  • New review related MQTT topics and API endpoints - New MQTT topics and api endpoints are available for reviews. These will likely be a better topic for notifications.

Fixes and changes

  • Better ONVIF support - PTZ controls will now show for more ONVIF PTZ cameras
  • Use ZMQ for interprocess communication
  • hwaccel_args are now automatically detected for Nvidia, AMD, and Intel based systems.
  • Stationary object detection has been improved especially for parked cars.
  • Additional support for IPV6
  • RTMP has been removed (after previous deprecation). This is handled by the automatic config migration upon upgrade.

FAQ

Have a question that's not answered here? Look at the most updated list of FAQs here or open a discussion on Github.

Upgrade issues

I'm seeing "add mask expects relative coordinates only" in my logs.
This is usually caused by a mask or zone having coordinates larger than the camera's detect resolution. The easiest fix would be to remove the mask/zone, restart Frigate, and use the new mask/zone editor to recreate it.

What happened to all my events?
An entirely new way of reviewing camera footage has been implemented in Frigate 0.14, so any "events" from any previous versions of Frigate will not be migrated and will not be visible in the new UI. This includes any favorited/starred events. Recordings can still be viewed in the new UI using the recordings viewer (From Live view, click/tap on a camera and select the History button at the top left).

I'm seeing "Preview Not Found" in the UI a lot. Why?
Frigate 0.14 now generates "previews": bandwidth-optimized, low frame rate, low resolution videos for your camera footage. These previews are not generated for any past footage from 0.13, so just wait an hour or two and try again. Historical full recordings are still viewable from your cameras, however. From Live view, click/tap on a camera and select the History button at the top left.

Usage

Can I make the cameras take up more space on my dashboard?
Yes you can, on desktop screens only. Create a camera group, and then use the edit layout button (bottom right) to resize/reposition your cameras on the dashboard.

Where is Birdseye view in the new UI?
Birdseye is accessible by creating a camera group and adding the Birdseye camera to the camera group.

Why are there black bars around my cameras in the dashboard?
The default layout keeps cameras in a 16x9 aspect ratio layout. On desktop screens, you can create a camera group and resize the camera to your liking.

Can I export footage from the review screen?
Yes, right click (desktop) or long press (mobile) to choose item(s) you want to export, then press the export button in the header.

What's Changed

New Contributors

Full Changelog: v0.13.2...v0.14.0-beta1