mirror of
https://github.com/blakeblackshear/frigate.git
synced 2026-05-01 19:17:41 +03:00
This change adds first-class adaptive recording playback using main and sub recording variants. Frigate can now store multiple recording variants per camera, expose those variants through the recordings API, and serve variant-specific VOD playlists through routes such as /vod/variant/sub/....
The UI now uses the available recording variants and browser playback capability to choose an appropriate playback source, with a user-selectable Auto, Main, and Sub preference. This is applied across timeline playback, export preview, and object detail playback.
The backend also includes a fallback path for sub playback: when a native sub recording is not available for a requested time range, Frigate can generate a lower-resolution sub recording from the main segment, store it under the standard sub variant, and mark it with transcoded_from_main.
Additional changes include recording metadata for codec, resolution, bitrate, and variant; database migrations for recording variants and generated-sub tracking; tests for variant VOD selection and fallback behavior; improved storage graph sorting; and a small MQTT TLS guard so tls_insecure is only applied when TLS is configured.
Substream Configuration Examples
Record the main stream as the normal full-resolution recording and also record the camera substream as the sub variant:
cameras:
front_door:
ffmpeg:
inputs:
- path: rtsp://user:password@192.168.1.10:554/main
roles:
- record
record_variant: main
- path: rtsp://user:password@192.168.1.10:554/sub
roles:
- detect
- record
record_variant: sub
detect:
width: 640
height: 360
fps: 5
record:
enabled: true
Using go2rtc restreams:
go2rtc:
streams:
front_door:
- rtsp://user:password@192.168.1.10:554/main
front_door_sub:
- rtsp://user:password@192.168.1.10:554/sub
cameras:
front_door:
ffmpeg:
inputs:
- path: rtsp://127.0.0.1:8554/front_door
input_args: preset-rtsp-restream
roles:
- record
record_variant: main
- path: rtsp://127.0.0.1:8554/front_door_sub
input_args: preset-rtsp-restream
roles:
- detect
- record
record_variant: sub
detect:
width: 640
height: 360
fps: 5
record:
enabled: true
If record_variant is omitted on a record input, it defaults to main. Each camera can only use a given recording variant once, so the main and sub recording inputs should use distinct variant names.
57 lines
1.5 KiB
JSON
57 lines
1.5 KiB
JSON
{
|
|
"noRecordingsFoundForThisTime": "No recordings found for this time",
|
|
"noPreviewFound": "No Preview Found",
|
|
"noPreviewFoundFor": "No Preview Found for {{cameraName}}",
|
|
"playbackPreference": {
|
|
"auto": "Auto",
|
|
"main": "Main",
|
|
"sub": "Sub"
|
|
},
|
|
"submitFrigatePlus": {
|
|
"title": "Submit this frame to Frigate+?",
|
|
"submit": "Submit"
|
|
},
|
|
"livePlayerRequiredIOSVersion": "iOS 17.1 or greater is required for this live stream type.",
|
|
"streamOffline": {
|
|
"title": "Stream Offline",
|
|
"desc": "No frames have been received on the {{cameraName}} <code>detect</code> stream, check error logs"
|
|
},
|
|
"cameraDisabled": "Camera is disabled",
|
|
"stats": {
|
|
"streamType": {
|
|
"title": "Stream Type:",
|
|
"short": "Type"
|
|
},
|
|
"bandwidth": {
|
|
"title": "Bandwidth:",
|
|
"short": "Bandwidth"
|
|
},
|
|
"latency": {
|
|
"title": "Latency:",
|
|
"value": "{{seconds}} seconds",
|
|
"short": {
|
|
"title": "Latency",
|
|
"value": "{{seconds}} sec"
|
|
}
|
|
},
|
|
"totalFrames": "Total Frames:",
|
|
"droppedFrames": {
|
|
"title": "Dropped Frames:",
|
|
"short": {
|
|
"title": "Dropped",
|
|
"value": "{{droppedFrames}} frames"
|
|
}
|
|
},
|
|
"decodedFrames": "Decoded Frames:",
|
|
"droppedFrameRate": "Dropped Frame Rate:"
|
|
},
|
|
"toast": {
|
|
"success": {
|
|
"submittedFrigatePlus": "Successfully submitted frame to Frigate+"
|
|
},
|
|
"error": {
|
|
"submitFrigatePlusFailed": "Failed to submit frame to Frigate+"
|
|
}
|
|
}
|
|
}
|