Feature: automatic camera resolution configuration

docs/docs/configuration/camera_specific.md

@@ -80,8 +80,8 @@ cameras:
     rtmp:
       enabled: False # <-- RTMP should be disabled if your stream is not H264
     detect:
-      width: # <---- update for your camera's resolution
-      height: # <---- update for your camera's resolution
+      width: # <- optional, by default Frigate try to automatically detect resolution 
+      height: # <- optional, by default Frigate try to automatically detect resolution 
 ```
 
 ### Blue Iris RTSP Cameras

docs/docs/configuration/cameras.md

@@ -33,8 +33,8 @@ cameras:
           roles:
             - record
     detect:
-      width: 1280
-      height: 720
+      width: 1280 # <- optional, by default Frigate try to automatically detect resolution 
+      height: 720 # <- optional, by default Frigate try to automatically detect resolution 
 ```
 
 Additional cameras are simply added to the config under the `cameras` entry.

docs/docs/configuration/index.md

   height: 720 
 detect: 
   # Optional: width of the frame for the input with the detect role (default: shown below) 
   width: 1280 
   # Optional: height of the frame for the input with the detect role (default: shown below) 
   height: 720 
@@ -20,8 +20,8 @@ cameras:
           roles:
             - detect
     detect:
-      width: 1280
-      height: 720
+      width: # <- optional, by default Frigate try to automatically detect resolution 
+      height: # <- optional, by default Frigate try to automatically detect resolution 
 ```
 
 ### VSCode Configuration Schema

docs/docs/development/contributing.md

@@ -69,8 +69,8 @@ cameras:
           roles:
             - detect
     detect:
-      height: 1080
-      width: 1920
+      height: 1080 # <- optional, by default Frigate try to automatically detect resolution 
+      width: 1920 # <- optional, by default Frigate try to automatically detect resolution 
       fps: 5
 ```
 

docs/docs/guides/getting_started.md

@@ -22,8 +22,6 @@ cameras:
             - detect
     detect:
       enabled: False # <---- disable detection until you have a working camera feed
-      width: 1280 # <---- update for your camera's resolution
-      height: 720 # <---- update for your camera's resolution
 ```
 
 ### Step 2: Start Frigate
@@ -106,8 +104,7 @@ cameras:
           roles:
             - detect
     detect:
-      width: 1280
-      height: 720
+      fps: 5
     motion:
       mask:
         - 0,461,3,0,1919,0,1919,843,1699,492,1344,458,1346,336,973,317,869,375,866,432

frigate/config.py

@@ -29,6 +29,7 @@
     deep_merge,
     escape_special_characters,
     get_ffmpeg_arg_list,
+    get_video_properties,
     load_config_with_no_duplicates,
 )
 
@@ -43,6 +44,7 @@
 
 DEFAULT_TRACKED_OBJECTS = ["person"]
 DEFAULT_DETECTORS = {"cpu": {"type": "cpu"}}
+DEFAULT_DETECT_DIMENSIONS = {"width": 1280, "height": 720}
 
 
 class FrigateBaseModel(BaseModel):
@@ -266,8 +268,8 @@ class StationaryConfig(FrigateBaseModel):
 
 
 class DetectConfig(FrigateBaseModel):
-    height: int = Field(default=720, title="Height of the stream for the detect role.")
-    width: int = Field(default=1280, title="Width of the stream for the detect role.")
+    height: Optional[int] = Field(title="Height of the stream for the detect role.")
+    width: Optional[int] = Field(title="Width of the stream for the detect role.")
     fps: int = Field(
         default=5, title="Number of frames per second to process through detection."
     )
@@ -954,6 +956,29 @@ def runtime_config(self, plus_api: PlusApi = None) -> FrigateConfig:
                 {"name": name, **merged_config}
             )
 
+            if (
+                camera_config.detect.height is None
+                or camera_config.detect.width is None
+            ):
+                for input in camera_config.ffmpeg.inputs:
+                    if "detect" in input.roles:
+                        try:
+                            streamInfo = get_video_properties(input.path)
+                            camera_config.detect.width = streamInfo["width"]
+                            camera_config.detect.height = streamInfo["height"]
+                            break
+                        except Exception:
+                            camera_config.detect.width = DEFAULT_DETECT_DIMENSIONS[
+                                "width"
+                            ]
+                            camera_config.detect.height = DEFAULT_DETECT_DIMENSIONS[
+                                "height"
+                            ]
+                            logger.warn(
+                                f"Error detecting stream resolution automatically for {input.path} Applying default values."
+                            )
+                            continue
+
             # Default max_disappeared configuration
             max_disappeared = camera_config.detect.fps * 5
             if camera_config.detect.max_disappeared is None:

frigate/util.py

@@ -1144,3 +1144,34 @@ def to_relative_box(
         (box[2] - box[0]) / width,  # w
         (box[3] - box[1]) / height,  # h
     )
+
+
+def get_video_properties(url, get_duration=False):
+    width = height = 0
+    # Open the video stream
+    video = cv2.VideoCapture(url)
+
+    # Check if the video stream was opened successfully
+    if not video.isOpened():
+        logger.debug(f"Error opening video stream {url}.")
+        return None
+
+    # Get the width of frames in the video stream
+    width = video.get(cv2.CAP_PROP_FRAME_WIDTH)
+
+    # Get the height of frames in the video stream
+    height = video.get(cv2.CAP_PROP_FRAME_HEIGHT)
+
+    # Release the video stream
+    video.release()
+
+    result = {"width": round(width), "height": round(height)}
+    if get_duration:
+        # Get the frames per second (fps) of the video stream
+        fps = video.get(cv2.CAP_PROP_FPS)
+        total_frames = int(video.get(cv2.CAP_PROP_FRAME_COUNT))
+        duration = total_frames / fps
+
+        result["duration"] = duration
+
+    return result