Cameras and Doorbells

Why Is My Home Assistant Camera Feed Black or Not Loading?

Home Assistant camera feed black or not loading? Check the RTSP URL, codec, keyframe interval, stream integration, and network before blaming Home Assistant.

On this page
  1. Start with the snapshot test
  2. Step 1: Test the RTSP URL outside Home Assistant
  3. Step 2: Check the codec
  4. Step 3: Set the keyframe interval
  5. Step 4: Check the stream integration and logs
  6. Step 5: Check the network and Wi-Fi
  7. Step 6: Check the camera itself
  8. Cloud cameras and black screens
  9. Step 7: Check the browser and app
  10. Dashboard card setting
  11. When a restart doesn’t help
  12. Common misconceptions
  13. Related guides

Start with the snapshot test

Check whether the snapshot loads while the live view is black. If the snapshot works but the live view is black, the problem is in the stream path, such as the codec, HLS or WebRTC, or keyframes. It’s usually not a connection problem, because snapshots and live streams use different paths. If nothing loads at all, the camera is probably unreachable or the address is wrong.

Step 1: Test the RTSP URL outside Home Assistant

Open the stream in VLC (Media > Open Network Stream), or run ffprobe against the address. Then check the result:

  • If VLC also fails, the cause is the URL path, the credentials, port 554, or RTSP being disabled on the camera.
  • If VLC plays the stream, the problem is in Home Assistant or in the codec.

If your password has special characters, URL-encode them in the address. For example, @ becomes %40 and # becomes %23.

Step 2: Check the codec

H.265 (HEVC) often shows as black in Chrome and Firefox. Switch the camera’s main stream to H.264, or use the substream. Safari generally handles H.265. You can usually find the codec in the camera’s video settings.

Step 3: Set the keyframe interval

Set the keyframe (I-frame) interval to one or two seconds. Long intervals, known as long GOPs, delay or block HLS playback.

Step 4: Check the stream integration and logs

Confirm that default_config: or stream: is in your configuration. The stream integration is part of default_config. For more detail, go to Settings > System > Logs (see how to find and read Home Assistant logs), or enable debug logging for the stream and generic integrations:

logger:
  logs:
    homeassistant.components.stream: debug
    homeassistant.components.generic: debug

Turn debug logging off once you have what you need, because it creates a lot of log output.

Step 5: Check the network and Wi-Fi

  • Changed IP address. A new address breaks the URL, so give the camera a DHCP reservation.
  • Weak 2.4 GHz Wi-Fi. A weak signal causes freezes and grey frames. Move the camera closer to the access point, or use a wired connection.
  • Too many connections. Cameras cap simultaneous connections. If your NVR, Frigate, and apps all connect, restream through go2rtc.

Step 6: Check the camera itself

  • Privacy mode stops the stream and produces a black image.
  • Battery cameras sleep, so they may show black until they wake.
  • IR failure at night can produce a dark image.
  • Firmware updates can reset RTSP or ONVIF to off. Reboot the camera and recheck its settings.

Cloud cameras and black screens

Cloud-based cameras, such as Nest, Ring, and Blink, depend on the brand’s streaming service. A black feed can come from outside your network, such as an error on the brand’s side. Check the brand’s app first. The Ring and Blink guide covers what each brand’s integration can show.

Step 7: Check the browser and app

Try another browser, or the Home Assistant Companion app. Clear the browser cache if the feed still won’t load.

Remote viewing over WebRTC needs STUN and TURN servers. Nabu Casa provides TURN for WebRTC. Reverse proxies may only handle HLS, so a remote feed can fail even when the local one works.

Dashboard card setting

With camera_view: auto, the card shows a still image refreshed about every 10 seconds. Use live to show the stream. For dashboards, use the substream, because the 4K main stream loads more slowly.

When a restart doesn’t help

Restarting Home Assistant clears some temporary errors, but it doesn’t fix camera-side limits. If the camera has RTSP turned off, privacy mode on, or has hit a connection limit, you’ll need to change the setting on the camera itself.

Common misconceptions

  • “A black feed means Home Assistant is broken.” It’s usually the codec, the address, or the network.
  • “Snapshot works, so the stream must.” They use different paths.
  • “The 4K main stream is fine for dashboards.” The substream loads faster.
  • “Restarting Home Assistant fixes it.” Camera-side limits persist.

The complete guide to cameras and doorbells

Home Assistant Cameras: Adding RTSP Streams and Choosing Cameras
Read the guide

Keep exploring

Guides from other topics

All topics →