diff --git a/docs/docs/frigate/camera_setup.md b/docs/docs/frigate/camera_setup.md index 06d7d3b4a..64c650c13 100644 --- a/docs/docs/frigate/camera_setup.md +++ b/docs/docs/frigate/camera_setup.md @@ -11,6 +11,12 @@ Cameras configured to output H.264 video and AAC audio will offer the most compa - **Stream Viewing**: This stream will be rebroadcast as is to Home Assistant for viewing with the stream component. Setting this resolution too high will use significant bandwidth when viewing streams in Home Assistant, and they may not load reliably over slower connections. +:::tip + +For the best experience in Frigate's UI, configure your camera so that the detection and recording streams use the same aspect ratio. For example, if your main stream is 3840x2160 (16:9), set your substream to 640x360 (also 16:9) instead of 640x480 (4:3). While not strictly required, matching aspect ratios helps ensure seamless live stream display and preview/recordings playback. + +::: + ### Choosing a detect resolution The ideal resolution for detection is one where the objects you want to detect fit inside the dimensions of the model used by Frigate (320x320). Frigate does not pass the entire camera frame to object detection. It will crop an area of motion from the full frame and look in that portion of the frame. If the area being inspected is larger than 320x320, Frigate must resize it before running object detection. Higher resolutions do not improve the detection accuracy because the additional detail is lost in the resize. Below you can see a reference for how large a 320x320 area is against common resolutions. diff --git a/frigate/video.py b/frigate/video.py index a139c25f1..615c61d61 100755 --- a/frigate/video.py +++ b/frigate/video.py @@ -64,10 +64,12 @@ def stop_ffmpeg(ffmpeg_process: sp.Popen[Any], logger: logging.Logger): try: logger.info("Waiting for ffmpeg to exit gracefully...") ffmpeg_process.communicate(timeout=30) + logger.info("FFmpeg has exited") except sp.TimeoutExpired: logger.info("FFmpeg didn't exit. Force killing...") ffmpeg_process.kill() ffmpeg_process.communicate() + logger.info("FFmpeg has been killed") ffmpeg_process = None diff --git a/web/src/components/overlay/detail/TrackingDetails.tsx b/web/src/components/overlay/detail/TrackingDetails.tsx index 767a7072a..03b6dd6c4 100644 --- a/web/src/components/overlay/detail/TrackingDetails.tsx +++ b/web/src/components/overlay/detail/TrackingDetails.tsx @@ -13,7 +13,7 @@ import HlsVideoPlayer from "@/components/player/HlsVideoPlayer"; import { baseUrl } from "@/api/baseUrl"; import { REVIEW_PADDING } from "@/types/review"; import { - ASPECT_VERTICAL_LAYOUT, + ASPECT_PORTRAIT_LAYOUT, ASPECT_WIDE_LAYOUT, Recording, } from "@/types/record"; @@ -39,6 +39,7 @@ import { useApiHost } from "@/api"; import ImageLoadingIndicator from "@/components/indicators/ImageLoadingIndicator"; import ObjectTrackOverlay from "../ObjectTrackOverlay"; import { useIsAdmin } from "@/hooks/use-is-admin"; +import { VideoResolutionType } from "@/types/live"; type TrackingDetailsProps = { className?: string; @@ -253,16 +254,25 @@ export function TrackingDetails({ const [timelineSize] = useResizeObserver(timelineContainerRef); + const [fullResolution, setFullResolution] = useState({ + width: 0, + height: 0, + }); + const aspectRatio = useMemo(() => { if (!config) { return 16 / 9; } + if (fullResolution.width && fullResolution.height) { + return fullResolution.width / fullResolution.height; + } + return ( config.cameras[event.camera].detect.width / config.cameras[event.camera].detect.height ); - }, [config, event]); + }, [config, event, fullResolution]); const label = event.sub_label ? event.sub_label @@ -460,7 +470,7 @@ export function TrackingDetails({ return "normal"; } else if (aspectRatio > ASPECT_WIDE_LAYOUT) { return "wide"; - } else if (aspectRatio < ASPECT_VERTICAL_LAYOUT) { + } else if (aspectRatio < ASPECT_PORTRAIT_LAYOUT) { return "tall"; } else { return "normal"; @@ -556,6 +566,7 @@ export function TrackingDetails({ onSeekToTime={handleSeekToTime} onUploadFrame={onUploadFrameToPlus} onPlaying={() => setIsVideoLoading(false)} + setFullResolution={setFullResolution} isDetailMode={true} camera={event.camera} currentTimeOverride={currentTime} @@ -623,7 +634,7 @@ export function TrackingDetails({
1 && aspectRatio < 1.5 + aspectRatio > 1 && aspectRatio < ASPECT_PORTRAIT_LAYOUT ? "lg:basis-3/5" : "lg:basis-2/5", )} diff --git a/web/src/types/record.ts b/web/src/types/record.ts index 25820c3d9..dbe43653a 100644 --- a/web/src/types/record.ts +++ b/web/src/types/record.ts @@ -44,4 +44,5 @@ export type RecordingStartingPoint = { export type RecordingPlayerError = "stalled" | "startup"; export const ASPECT_VERTICAL_LAYOUT = 1.5; +export const ASPECT_PORTRAIT_LAYOUT = 1.333; export const ASPECT_WIDE_LAYOUT = 2; diff --git a/web/src/views/settings/TriggerView.tsx b/web/src/views/settings/TriggerView.tsx index 28aa148fe..aabf89294 100644 --- a/web/src/views/settings/TriggerView.tsx +++ b/web/src/views/settings/TriggerView.tsx @@ -664,9 +664,7 @@ export default function TriggerView({ - - {t("name", { ns: "triggers.table.name" })} - + {t("triggers.table.name")} {t("triggers.table.type")} {t("triggers.table.lastTriggered")}