home-assistant · c0ffeeca7 · Nov 26, 2025 · Nov 2, 2025 · Nov 26, 2025 · Nov 26, 2025
diff --git a/source/_integrations/onvif.markdown b/source/_integrations/onvif.markdown
@@ -108,3 +108,17 @@ This integration uses the ONVIF auxiliary command and imaging service to send ce
 | IR lamp  | `ir_lamp` |  Turn infrared lamp on and off via `IrCutFilter` ONVIF imaging setting. |
 | Autofocus  | `autofocus` |  Turn autofocus on and off via `AutoFocusMode` ONVIF imaging setting. |
 | Wiper  | `wiper` |  Turn on the lens wiper on and off via the `Wiper` ONVIF auxiliary command. |
+
+## Troubleshooting
+
+### Symptom: Error message: "No usable cameras were found"
+
+The ONVIF integration shows an error message "No usable cameras were found". 
-The ONVIF integration shows an error message "No usable cameras were found". 
+When you try to set up the ONVIF integration in Home Assistant, you may see the error message "No usable cameras were found" if the integration cannot detect any compatible video streams from your camera.
-The ONVIF integration shows an error message "No usable cameras were found". 
+When you try to set up the ONVIF integration in Home Assistant, you may see the error message "No usable cameras were found" if the integration cannot detect any compatible video streams from your camera.
+
+#### Resolution
+
+Update the camera configuration to output at least one video stream in H.264 format rather than H.265. One option for doing this is to set a secondary stream to H.264 while leaving the primary stream at the default H.265.
+
-Update the camera configuration to output at least one video stream in H.264 format rather than H.265. One option for doing this is to set a secondary stream to H.264 while leaving the primary stream at the default H.265.
+To resolve this issue, you need to update your camera's configuration so that it outputs at least one video stream in H.264 format. Most cameras allow you to do this in their web interface or mobile app, typically under **Video**, **Stream**, or **Encoding** settings.
+
+1. Open your camera's web interface or app.
+2. Navigate to the **Video** or **Stream** settings section.
+3. Look for options to set the video encoding format for each stream.
+4. Change the encoding for at least one stream (often called the secondary or sub stream) to **H.264**. You can leave the primary stream set to **H.265** if you prefer.
+5. Save your changes.
+
+If you are unsure how to access these settings or change the encoding format, refer to your camera's user manual or manufacturer's support website for specific instructions.
-Update the camera configuration to output at least one video stream in H.264 format rather than H.265. One option for doing this is to set a secondary stream to H.264 while leaving the primary stream at the default H.265.
+To resolve this issue, you need to update your camera's configuration so that it outputs at least one video stream in H.264 format. Most cameras allow you to do this in their web interface or mobile app, typically under **Video**, **Stream**, or **Encoding** settings.
+
+1. Open your camera's web interface or app.
+2. Navigate to the **Video** or **Stream** settings section.
+3. Look for options to set the video encoding format for each stream.
+4. Change the encoding for at least one stream (often called the secondary or sub stream) to **H.264**. You can leave the primary stream set to **H.265** if you prefer.
+5. Save your changes.
+
+If you are unsure how to access these settings or change the encoding format, refer to your camera's user manual or manufacturer's support website for specific instructions.
+#### Cause 
+
+Many newer cameras, particularly those with higher resolutions that benefit from H.265's improved video coding, support H.265 (HEVC) by default, while the ONVIF integration looks for H.264 (AVC) video streams to find cameras.