- works in any modern browser, even on mobiles
- the only browser technology with minimal camera stream delays (0.5 seconds and below)
- works well with unstable channel
- does not use transcoding and does not load the CPU
- support camera stream with sound
Q. I can't see video stream
- If your camera works with another integration - this don't mean it will work with this integration
- If your camera works in VLC - this don't mean it will work with this integration
- If your camera works remotely with another integration - this don't mean it will work remotely with this integration
In case of any problems, check:
- Check that you have installed the integration on the "Configuration > Integrations" page
- Check that you are on the same network as your Hass server
- Check that you don't setup Hass server with forward only 8123 port (users with Virtual Machine or Docker installation or firewall), because WebRTC using 50000-50009 UDP ports for video streaming
- Check that you don't have any erros in "Configuration > Logs" page
- Check if default video with Bunny works:
type: 'custom:webrtc-camera' url: 'rtsp://wowzaec2demo.streamlock.net/vod/mp4:BigBuckBunny_115k.mov'
PS. Some mobile browsers can't show stream without HTTPS. There are also problems with the stream in the Firefox browser.
Q. Error: Custom element doesn't exist: webrtc-camera.
A. Component automatically adds custom card
/webrtc/webrtc-camera.js to your resources.
Check if you install component in "Integrations" page. And try to clear your browser cache. Also, you can try to add this card to your resources manually.
Q. How to setup exernal access?
A. External access will work only if you have public IP-address (without provider NAT). Dynamic address is also supported.
You need to forward UDP ports 50000-50009 to Hass server on your router.
50000-50009 ports are used only during video streaming. At each start of the streaming, a random port is occupied. The port is released when the streaming ends. The data should theoretically be encrypted, but I haven't tested :)
Q. Some streams are not loaded when there are many cameras on the page.
A. The default settings only support 10 simultaneous streams (from Hass server to app or browser). Go to "Configuration > Integrations > WebRTC Camera > Options" and increase port range. You also need forward new port range on your router if you want external access to cameras.
Q. Which codecs are supported?
A. WebRTC supported:
AVC/H.264 for video and
G.711 PCM (A-law),
G.711 PCM (µ-law) for audio.
WebRTC technology don't support
HEVC/H.265 for video and
AAC for audio.
You can install component with HACS custom repo: HACS > Integrations > 3 dots (upper top corner) > Custom repositories > URL:
AlexxIT/WebRTC > Category: Integration
Or manually copy
webrtc folder from latest release to
custom_components folder in your config folder.
With GUI. Configuration > Integration > Add Integration > WebRTC Camera.
If the integration is not in the list, you need to clear the browser cache.
Component doesn't create devices/entities/services. It creates only lovelace custom card:
type: 'custom:webrtc-camera' url: 'rtsp://rtsp:[email protected]:554/av_stream/ch0'
- macOS: Google Chrome, Safari
- Windows: Google Chrome
- Android: Google Chrome, Home Assistant Mobile App
- iOS: Home Assistant Mobile App
- works only with H.264 camaras
- for external access you need a public IP-address (without provider NAT), dynamic IP is also supported
Known work cameras:
- Sonoff GK-200MP2-B (support sound)
- EZVIZ C3S
- Hikvision: DS-2CD2T47G1-L, DS-2CD1321-I, DS-2CD2143G0-IS
- Reolink: RLC-410, RLC-410W, E1 Pro, 4505MP
- TP-Link: Tapo C200
- Wyze Cam v2 (support sound)