Aqara G4 in Home Assistant with go2rtc and WebRTC Camera

The Aqara Video Doorbell G4 works well in Home Assistant when you pair it via HomeKit first, then feed a low-latency stream through the go2rtc add-on and a WebRTC Camera card.

This guide covers: adding the G4 with HomeKit, installing go2rtc from the AlexxIT repository, the stream config, and the dashboard card.

Of everything I tried, this is the only method that gave me a stable, good-quality picture from the Aqara G4 in Home Assistant. The built-in HomeKit camera view without go2rtc is usually laggy and poor for a dashboard; other streaming options either failed or looked worse. The downside: audio never worked for me (more on that below).

1. Add the Aqara G4 to Home Assistant via HomeKit

First, add the doorbell to HA as a HomeKit device (HomeKit Device / HomeKit Controller integration). The pairing code is usually on the device or in the Aqara app.

After pairing, the device shows up in Home Assistant. In our case it was named:

Doorbell Repeater-6B47

That exact name is what you use later in go2rtc as the hass:… source. The camera entity becomes something like camera.doorbell_repeater_6b47 (spaces and hyphens become underscores, letters lowercase).

The stock HomeKit camera preview in HA is often laggy and awkward on a dashboard — that is why we add go2rtc.

2. Add the repository and install go2rtc

1. Open Settings → Add-ons → Add-on store.
2. Menu (three dots) → Repositories.
3. Add:
   https://github.com/AlexxIT/hassio-addons
4. Refresh the list and install the go2rtc add-on.
5. Start it and enable Start on boot (optionally “Show in sidebar”).

Repository: AlexxIT/hassio-addons.

3. Aqara G4 stream config in go2rtc

In the go2rtc add-on settings (or its YAML config), add a stream. The hass: source pulls the HomeKit camera already paired in Home Assistant by device name:

streams:
  aqara_g4:
    - hass:Doorbell Repeater-6B47
    - ffmpeg:aqara_g4#audio=aac#audio=opus

What this does:

• hass:Doorbell Repeater-6B47 — video (and raw HomeKit audio) from the device already in HA;
• ffmpeg:aqara_g4#audio=aac#audio=opus — attempt to transcode HomeKit audio (AAC-ELD) to AAC/Opus for WebRTC. In practice, audio never worked for us with this setup — video only.

If your device name in HA is different, paste it exactly instead of Doorbell Repeater-6B47, as shown on the device page.

Save the config and restart go2rtc. In the add-on UI, aqara_g4 should appear in the streams list.

Note on audio: we keep #audio=aac#audio=opus as recommended for HomeKit cameras, but the audio track from the Aqara G4 via go2rtc never came through. The WebRTC card shows video; there is no sound.

4. WebRTC Camera card on the dashboard

For low-latency viewing, use the custom WebRTC Camera card from the AlexxIT/WebRTC integration. The stock Camera card is a worse fit for this HomeKit stream — higher latency and less control.

Install the WebRTC integration

1. Install HACS if you do not have it yet.
2. In HACS open Integrations → search WebRTC Camera (by AlexxIT) → Download.
3. Restart Home Assistant.
4. Go to Settings → Devices & services → Add integration → find WebRTC Camera and add it.

After that, the card type custom:webrtc-camera is available in the dashboard editor.

How to add the card

1. Open the dashboard (Overview or another view) and tap the pencil Edit dashboard in the top right.
2. Tap Add card (or “+”).
3. At the bottom of the list choose Manual — the YAML editor opens. Or pick WebRTC if it already appears in the catalog, then switch to code mode.
4. Paste this config:

type: custom:webrtc-camera
entity: camera.doorbell_repeater_6b47

5. Tap Save on the card, then Done on the dashboard.

entity is the HomeKit camera ID in HA. In the example it is camera.doorbell_repeater_6b47 because the device is named Doorbell Repeater-6B47. Find yours here:

• Settings → Devices & services → Devices → open Doorbell Repeater-6B47 → Camera entity;
• or Developer tools → States, filter camera..

If your device name differs, use your own entity_id or the card will be empty or show an error.

If the card is missing or errors

• “Custom element doesn’t exist: webrtc-camera” — WebRTC is not installed, or HA was not restarted after the HACS install. Hard-refresh the page (Ctrl+F5).
• Black screen / no picture — check that go2rtc is running, aqara_g4 is in its streams list, and the card entity matches the real camera.
• Video but no audio — common with Aqara G4 via HomeKit + go2rtc: even with ffmpeg:…#audio=aac#audio=opus, audio never worked for us. The WebRTC card still shows a solid picture.

Quick checklist

1. Aqara G4 added to HA via HomeKit → name like Doorbell Repeater-6B47.
2. Repository https://github.com/AlexxIT/hassio-addons → go2rtc add-on installed.
3. go2rtc stream aqara_g4 with hass:… and ffmpeg:…#audio=aac#audio=opus.
4. Dashboard card custom:webrtc-camera with your camera entity.

You can then watch the Aqara G4 doorbell in Home Assistant through go2rtc with low latency and decent video quality — for me this is still the only reliable way to get a stable G4 picture in HA. Audio in the HomeKit → go2rtc → WebRTC chain never worked: plan on video without sound, or look for a separate audio path.