📞 Ring Intercom Video Card

A Home Assistant custom Lovelace card with two-way audio and video for the Ring Intercom Video device (2024/2025 model with built-in camera).

This is the frontend card. It needs the companion backend custom integration to work — see Dependencies below.

---

✨ Features

• 📹 Live video stream from the intercom (native WebRTC, no transcoding)
• 🎤 Two-way audio with push-to-talk button
• 🔓 Open door button (uses Ring's native lock.unlock or any custom service)
• 📵 Hang up button (clean session teardown, releases mic and camera)
• 🛠 Visual editor with entity pickers — no YAML needed
• 🌍 Multi-language UI with auto-detection: Spanish, English, Catalan
• 🔌 Pure browser-side WebRTC, no go2rtc, no extra add-ons, no transcoding server
• 🌐 Works on desktop and mobile browsers (with HTTPS)

---

🧩 Dependencies

This card is only the user interface. For it to actually work, you also need:

⚙️ Backend integration (REQUIRED)

👉 ring-intercom-video custom integration.

This integration is what creates the camera.* entity for your Ring Intercom Video and handles the WebRTC signaling between Home Assistant and Ring's servers. Without it the card has nothing to connect to.

Install the backend integration first, verify it created a camera.* entity for your intercom, and only then install this card.

🌐 HTTPS access to Home Assistant

Browsers require a secure context to access the microphone (getUserMedia). If you access HA over plain HTTP (http://192.168.x.x:8123), the microphone will not work and you'll get one-way audio at best.

You need any of:

• 🏠 Nabu Casa Home Assistant Cloud (HTTPS automatic)
• 🔐 A reverse proxy with Let's Encrypt (nginx, Caddy, Traefik, Nginx Proxy Manager...)
• 🔒 Native HA HTTPS with a valid certificate

📋 Other requirements

• 🏡 Home Assistant 2024.4 or newer
• 📦 A Ring Intercom Handset Video device (the 2024/2025 model with camera) paired in your Ring account
• 🌍 A modern browser (Chrome, Firefox, Safari, Edge — all current versions)

---

📥 Installation

🟢 Via HACS (recommended)

Step by step:

1️⃣ Make sure HACS is installed

If you don't have HACS, install it first following the official HACS docs. Then come back here.

2️⃣ Install the backend integration

Before this card, you need ring-intercom-video installed:

1. In HACS → Integrations → click ⋮ (top right) → Custom repositories
2. Add:
   • Repository: https://github.com/cmos486/ring-intercom-video
   • Type: Integration
3. Install Ring Intercom Video Camera
4. Restart Home Assistant
5. Verify: a camera.* entity has appeared for your intercom (look in Settings → Devices & Services → Ring)

If this step doesn't produce a camera entity, fix that first — the card will not work without it.

3️⃣ Install this card via HACS

1. In HACS → Frontend → click ⋮ (top right) → Custom repositories
2. Add:
   • Repository: https://github.com/cmos486/ring-intercom-video-card
   • Type: Lovelace
3. Find Ring Intercom Video Card in the list and click Download
4. HACS will register the JavaScript resource automatically
5. Hard refresh your browser: Ctrl+Shift+R (Windows/Linux) or Cmd+Shift+R (macOS)
6. ✅ Done

To confirm it loaded, open the browser console (F12) — you should see a blue banner like:

 RING-INTERCOM-VIDEO-CARD  v1.1.0

🔧 Manual installation (alternative)

If you prefer not to use HACS:

1. Download ring-intercom-video-card.js from the latest release
2. Copy it to /config/www/ring-intercom-video-card.js on your HA instance
3. Go to Settings → Dashboards → ⋮ → Resources and add:
   • URL: /local/ring-intercom-video-card.js
   • Resource type: JavaScript Module
4. Hard refresh your browser

---

➕ Adding the card to a dashboard

1. Open the dashboard where you want the card
2. Click ✏️ Edit dashboard (pencil icon, top right)
3. Click ➕ Add Card
4. Search for Ring Intercom Video Card in the picker
5. The visual editor will open:
   • 📹 Camera entity: pick the camera.* created by the backend integration
   • 🔓 Lock entity (optional): pick the lock.* provided by the Ring integration to enable the "Open door" button
   • 🌍 Language (optional): override the auto-detected language (defaults to your HA language)
   • ⚙️ Advanced (toggle): instead of a simple lock, you can call any service when "Open door" is pressed
6. Click Save

---

⚙️ Configuration

The visual editor covers the typical cases, but here's the full schema for reference:

Option	Type	Required	Description
entity	string	✅ Yes	Camera entity from the backend integration (camera.*)
lock_entity	string	❌ No	Lock entity used for the "Open door" button. Calls lock.unlock.
open_door_action	object	❌ No	Advanced: custom service call for "Open door". Overrides lock_entity if set.
open_door_action.service	string	—	Service to call (e.g. script.turn_on, automation.trigger)
open_door_action.entity_id	string	—	Entity passed as entity_id to the service
open_door_action.data	object	—	Additional service data
language	string	❌ No	Force UI language: es, en, ca. If omitted, follows Home Assistant's language.

📝 Example — Simple (just lock)

type: custom:ring-intercom-video-card
entity: camera.entrada_principal_video_camera
lock_entity: lock.entrada_principal_video_lock

📝 Example — Advanced (custom service)

type: custom:ring-intercom-video-card
entity: camera.entrada_principal_video_camera
open_door_action:
  service: script.turn_on
  entity_id: script.abrir_puerta

📝 Example — Forced language

type: custom:ring-intercom-video-card
entity: camera.entrada_principal_video_camera
lock_entity: lock.entrada_principal_video_lock
language: ca

📝 Example — No door button

If neither lock_entity nor open_door_action is configured, the Open door button is automatically hidden. Useful if you only want video + audio.

type: custom:ring-intercom-video-card
entity: camera.entrada_principal_video_camera

---

🌍 Internationalization

The card UI is available in:

Code	Language
🇪🇸 es	Español
🇬🇧 en	English
🇪🇸 ca	Català

Auto-detection: by default, the card reads hass.locale.language (or hass.language) and picks the matching translation. If your HA is set to Spanish, the card shows Spanish. If it's set to Italian (not supported yet), it falls back to English.

Manual override: set the language option in the card config to force a specific language regardless of HA.

Want another language? PRs welcome — add a new block to the TRANSLATIONS constant in ring-intercom-video-card.js.

---

🎬 How to use it

When someone rings the intercom or you just want to check the door:

1. 🛎️ Intercom rings (or you decide to peek)
2. 👆 Click 📞 Pick up / Descolgar / Despenjar
3. 🎤 Browser asks for microphone permission → Allow (first time only)
4. ⏳ Wait a second or two — you'll see PC state: connected in the overlay
5. 📺 Live video appears, the green push-to-talk button activates
6. 🗣️ Hold the green button to speak through the intercom
7. 🔓 Click 🔓 Open door / Abrir puerta / Obrir porta to unlock the door
8. 📵 Click 📵 Hang up / Colgar / Penjar when you're done

💡 Tips

• The microphone is muted by default — you have to hold the button to send audio. Release it as soon as you stop talking to avoid echo.
• The audio from the door is always heard while connected — you don't need to press anything to hear them.
• If you forget to hang up, the indoor intercom handset may stay "occupied" and not work normally. Always hang up when you finish.
• The card uses native browser WebRTC — latency is typically under 300ms.

---

🪟 Auto-popup on incoming call (Browser Mod integration)

A common use case: when someone rings the intercom, automatically show the card as a popup on your wall panel / tablet without the user having to navigate to a specific dashboard.

This is achieved with the browser_mod custom integration.

🧩 Requirements

• 📱 Browser Mod installed via HACS
• 🌐 The target device (tablet, wall panel...) needs to be registered as a browser in Browser Mod with a known browser_id (e.g. wallpanel)
• 🛎️ A trigger entity from your intercom — typically event.<your_intercom>_timbre_de_la_puerta or similar binary_sensor.*_ding from the Ring integration

⚙️ Setup steps

1. Install Browser Mod from HACS

HACS → Integrations → search Browser Mod → Download → Restart HA → Settings → Devices & services → Add integration → Browser Mod.

2. Register your device as a browser

On the target device (e.g. wall panel tablet):

1. Open HA in the app or browser
2. Navigate to menu → Browser Mod (or directly to /browser-mod)
3. Enter a recognizable name in Browser ID (e.g. wallpanel)
4. Activate ☑️ Register, ☑️ Camera, ☑️ Microphone
5. Save

3. Create the popup automation

Use this automation as a starting point. Replace entity IDs with your own:

alias: popup_intercom_llamada_wallpanel
description: >
  Shows the intercom card as a popup on the wall panel when the doorbell rings.
  Auto-closes after 60s of inactivity.
mode: restart
trigger:
  - platform: state
    entity_id: event.entrada_principal_video_timbre_de_la_puerta
action:
  - service: browser_mod.popup
    data:
      browser_id:
        - wallpanel
      title: Llamada en el portero
      content:
        type: custom:ring-intercom-video-card
        entity: camera.entrada_principal_video_camera
        lock_entity: lock.entrada_principal_video_lock
      dismissable: true
      autoclose: false
      timeout: 60000
      style: "--popup-min-width: 480px; --popup-max-width: 520px;"

4. Wake up the screen (optional but recommended)

If your tablet's screen is off when the doorbell rings, you'll want to wake it up first. The HA Companion app supports a command for this:

alias: activar_pantalla_wallpanel_por_timbre
description: Wake up wallpanel screen when doorbell rings
trigger:
  - platform: state
    entity_id: event.entrada_principal_video_timbre_de_la_puerta
action:
  - service: notify.mobile_app_wallpanel
    data:
      message: command_screen_on

Note: notify.mobile_app_wallpanel is created automatically when you install the HA Companion app on the tablet and name it wallpanel.

🎨 Customizing the popup

Centering / sizing

The style: field accepts CSS variables specific to Browser Mod:

style: |
  --popup-min-width: 480px;
  --popup-max-width: 520px;
  --popup-border-radius: 16px;

Show only at certain hours

If you don't want the popup to appear at night:

condition:
  - condition: time
    after: "06:00:00"
    before: "23:00:00"

Send notification to phone when no one's home

Combine the popup with a notify.* to your phone:

action:
  - choose:
      - conditions:
          - condition: state
            entity_id: person.you
            state: home
        sequence:
          - service: browser_mod.popup
            data:
              browser_id:
                - wallpanel
              # ... (popup config above)
      - conditions:
          - condition: state
            entity_id: person.you
            state: not_home
        sequence:
          - service: notify.mobile_app_your_phone
            data:
              title: "🛎️ Doorbell"
              message: "Someone is at the door"

---

🔍 How it works (technical)

For the curious:

Browser  <──signaling via HA──>  Ring Cloud  <──media P2P──>  Ring Intercom
   │                                                                │
   └──────── audio + video over WebRTC (peer-to-peer) ──────────────┘

• The card builds an RTCPeerConnection with two transceivers: audio: sendrecv and video: recvonly
• It calls Home Assistant's standard camera/webrtc/offer WebSocket API
• The backend integration (ring-intercom-video) forwards the SDP offer to Ring's signaling servers
• ICE candidates are exchanged via camera/webrtc/candidate
• Once negotiated, media flows peer-to-peer (Ring may use TURN relays depending on NAT)
• No transcoding, no extra services, no go2rtc

This is the same WebRTC machinery the official HA Ring integration already uses for doorbell cameras — this card just adds the missing UI and the microphone track on top.

---

🧯 Troubleshooting

❓ "Requesting microphone..." hangs or fails

The browser is rejecting the microphone request:

• 🔒 You're accessing HA over plain HTTP. Switch to HTTPS (Nabu Casa, Let's Encrypt, etc.)
• 🚫 You denied permission previously. Click the lock/info icon in the address bar and reset site permissions
• 🎙️ No microphone available on your device

🎥 Video shows but no audio reaches the door

• Check that the green button actually turns red while held
• Open DevTools (F12) → Console — you should see [ring-intercom-video-card] Mic: ON when pressing
• Make sure you're on HTTPS — some browsers silently mute mic on insecure contexts

❌ PC state: failed right after connecting

Usually a network/NAT issue:

• Check that your client can reach Ring's WebRTC endpoints
• Look at ICE candidate errors in DevTools console
• Try from a different network (e.g. mobile data) to isolate

📷 Camera entity not appearing in the editor dropdown

• Verify ring-intercom-video is installed and Ring discovered the device
• Restart Home Assistant after installing the backend
• Check Settings → Devices & Services → Ring — your intercom should be listed

🔄 The card says "Loaded v0.x.x" — old version

You're caching an old copy:

• Hard refresh: Ctrl+Shift+R (Win/Linux) or Cmd+Shift+R (macOS)
• Clear the Lovelace resource cache by toggling its URL with a ?v=X query param
• In HACS, re-download the card if needed

🛎️ "Open door" doesn't actually unlock

• If using lock_entity: make sure lock.unlock works manually on that entity (Developer Tools → Services)
• If using open_door_action: check the service exists and works standalone
• Look at HA logs around the time you pressed the button

🪟 Browser_mod popup doesn't appear

• Verify sensor.<browser_id>_browser_id state is the expected name (not unavailable)
• If you changed the HA URL (e.g. HTTP → HTTPS), Browser Mod loses the registration. Re-register on the device after changing URLs
• Make sure the target browser is active and visible (sensor.<browser_id>_browser_visibility should be visible for the popup to render). If the screen is off, send command_screen_on first

🌍 Card shows in English when my HA is in another language

• If the language code is unsupported, the card falls back to English. Supported: es, en, ca. PRs welcome to add more
• You can force a language by setting language: es (or en, ca) in the card config

---

🤝 Contributing

Pull requests and issues welcome! When reporting a bug please include:

• 🏡 Home Assistant version
• 🌐 Browser and version
• 🖥️ Console logs from the card (search for [ring-intercom-video-card])
• 🎟️ A description of what you expected vs. what happened

To add a new language, edit ring-intercom-video-card.js and add a new key to the TRANSLATIONS constant. All keys must match the existing ones — see en for the canonical reference.

---

🙏 Credits

• 📦 Built on top of python-ring-doorbell and the HA Ring integration
• 🤝 Companion to ring-intercom-video by the same author
• 🪟 Auto-popup feature uses browser_mod by @thomasloven

---

📜 License

Apache License 2.0

Copyright © 2026 Kilian Ubeda Cano