Add mjpeg warning (#24954)

docs/docs/frigate/hardware.md

@@ -9,7 +9,7 @@ import CommunityBadge from '@site/src/components/CommunityBadge';
 
 Cameras that output H.264 video and AAC audio will offer the most compatibility with all features of Frigate and Home Assistant. It is also helpful if your camera supports multiple substreams to allow different resolutions to be used for detection, streaming, and recordings without re-encoding.
 
-I recommend Dahua, Hikvision, and Amcrest in that order. Dahua edges out Hikvision because they are easier to find and order, not because they are better cameras. I personally use Dahua cameras because they are easier to purchase directly. In my experience Dahua and Hikvision both have multiple streams with configurable resolutions and frame rates and rock solid streams. They also both have models with large sensors well known for excellent image quality at night. Not all the models are equal. Larger sensors are better than higher resolutions; especially at night. Amcrest is the fallback recommendation because they are rebranded Dahuas. They are rebranding the lower end models with smaller sensors or less configuration options.
+I recommend Dahua and Hikvision. Dahua edges out Hikvision because they are easier to find and order, not because they are better cameras. I personally use Dahua cameras because they are easier to purchase directly. In my experience Dahua and Hikvision both have multiple streams with configurable resolutions and frame rates and rock solid streams. They also both have models with large sensors well known for excellent image quality at night. Not all the models are equal. Larger sensors are better than higher resolutions; especially at night.
 
 WiFi cameras are not recommended as [their streams are less reliable and cause connection loss and/or lost video data](https://ipcamtalk.com/threads/camera-conflicts.68142/#post-738821), especially when more than a few WiFi cameras will be used at the same time.
 
@@ -17,10 +17,9 @@ Many users have reported various issues with 4K-plus Reolink cameras, it is best
 
 Here are some of the cameras I recommend:
 
-- <a href="https://amzn.to/4fwoNWA" target="_blank" rel="nofollow noopener sponsored">Loryta(Dahua) IPC-T549M-ALED-S3</a> (affiliate link)
-- <a href="https://amzn.to/3YXpcMw" target="_blank" rel="nofollow noopener sponsored">Loryta(Dahua) IPC-T54IR-AS</a> (affiliate link)
-- <a href="https://amzn.to/3AvBHoY" target="_blank" rel="nofollow noopener sponsored">Amcrest IP5M-T1179EW-AI-V3</a> (affiliate link)
-- <a href="https://www.bhphotovideo.com/c/product/1705511-REG/hikvision_colorvu_ds_2cd2387g2p_lsu_sl_8mp_network.html" target="_blank" rel="nofollow noopener">HIKVISION DS-2CD2387G2P-LSU/SL ColorVu 8MP Panoramic Turret IP Camera</a> (affiliate link)
+- <a href="https://link.amazon/B0hnw1JEZ" target="_blank" rel="nofollow noopener sponsored">GemaVision(Dahua) IPC-T549M-ALED-S3</a> (affiliate link)
+- <a href="https://link.amazon/B06naLGqL" target="_blank" rel="nofollow noopener sponsored">GemaVision(Dahua) IPC-T54IR-AS</a> (affiliate link)
+- <a href="https://link.amazon/B0iD97zC7" target="_blank" rel="nofollow noopener sponsored">HIKVISION DS-2CD2387G2P-LSU/SL ColorVu 8MP Panoramic Turret IP Camera</a> (affiliate link)
 
 I may earn a small commission for my endorsement, recommendation, testimonial, or link to any products or services from this website.
 

docs/docs/integrations/third_party_extensions.md

@@ -70,3 +70,7 @@ This is a fork (with fixed errors and new features) of [original Double Take](ht
 ## [Strix](https://github.com/eduard256/Strix)
 
 [Strix](https://github.com/eduard256/Strix) auto-discovers working stream URLs for IP cameras and generates ready-to-use Frigate configs. It tests thousands of URL patterns against your camera and supports cameras without RTSP or ONVIF. 67K+ camera models from 3.6K+ brands.
+
+## [yuFriEye](https://apps.apple.com/app/id6832456692)
+
+[yuFriEye](https://apps.apple.com/app/id6832456692) is a free native iOS, iPadOS and macOS client for Frigate. It shows the live camera grid with low-latency go2rtc streams, alerts and detections with clip playback and motion boxes, recordings by day with continuous playback, Frigate and go2rtc logs, and supports multiple servers with local and remote addresses. Works with or without Frigate authentication; no account or data collection.

docs/static/frigate-api.yaml

@@ -5374,6 +5374,10 @@ paths:
       tags:
         - Media
       summary: Mjpeg Feed
+      description: |-
+        **Access:** Authenticated user with access to the referenced camera.
+
+        An MJPEG stream of the camera's latest processed frame, intended for debugging only. Every frame of every open stream is color converted, annotated, resized, and JPEG encoded in Frigate's main process, which adds load to the system and can slow down Frigate's processing. It is strictly not recommended to view this stream continuously, such as on a dashboard. For live viewing, use a go2rtc restream instead. The frame rate and resolution can be raised with the fps and height parameters, for example ?fps=10&height=1080, at the cost of additional load.
       operationId: mjpeg_feed__camera_name__get
       parameters:
         - name: camera_name
@@ -5461,7 +5465,6 @@ paths:
       security:
         - frigateUserAuth: []
       x-required-role: camera
-      description: '**Access:** Authenticated user with access to the referenced camera.'
   /{camera_name}/ptz/info:
     get:
       tags:

frigate/api/media.py

@@ -74,7 +74,19 @@ def _resolve_cache_age(max_cache_age: int) -> int:
     return max_cache_age.default
 
 
-@router.get("/{camera_name}", dependencies=[Depends(require_camera_access)])
+@router.get(
+    "/{camera_name}",
+    dependencies=[Depends(require_camera_access)],
+    description=(
+        "An MJPEG stream of the camera's latest processed frame, intended for debugging only. "
+        "Every frame of every open stream is color converted, annotated, resized, and JPEG "
+        "encoded in Frigate's main process, which adds load to the system and can slow down "
+        "Frigate's processing. It is strictly not recommended to view this stream "
+        "continuously, such as on a dashboard. For live viewing, use a go2rtc restream "
+        "instead. The frame rate and resolution can be raised with the fps and height "
+        "parameters, for example ?fps=10&height=1080, at the cost of additional load."
+    ),
+)
 async def mjpeg_feed(
     request: Request,
     camera_name: str,