Skip to content

Latest commit

 

History

History
68 lines (51 loc) · 3.28 KB

File metadata and controls

68 lines (51 loc) · 3.28 KB

Optional temporary Ring backend patch

← Ring View

Do I need another integration?

No. Ring View's recording, Live, and supported two-way audio features use the official Home Assistant Ring integration. The card adds no Ring login of its own. You can use it without the patch.

The separate Ring WebRTC Backend Patch is a temporary workaround for a specific session-cleanup defect in the ring-doorbell library used by Home Assistant. It runs alongside the built-in Ring integration; it does not replace it, create new camera entities, or take over authentication.

What problem does it address?

When Ring closes a WebRTC session, the library's reader task can enter cleanup and try to await itself. Python rejects that with RuntimeError: Task cannot await on itself. Cleanup then exits prematurely, and a later Live connection may fail or take longer to recover.

This can be exposed by closing/reopening Live, reconnecting, or an iOS Companion Web View reload during rotation. Rotation is a trigger in some setups—not the underlying library defect.

The patch guards against that self-await. It does not change media negotiation, camera credentials, or the dashboard. Version 0.1.1 deliberately supports only ring-doorbell 0.9.14 and checks the method signature before patching; it will not silently patch an unknown library version.

With and without the patch

  • Without it: use Ring View normally. The backend defect may still affect repeated Live sessions; not every playback failure is caused by this defect.
  • With it: the same features and entity IDs remain available, with the guarded cleanup on a supported backend version.
  • Either way: HTTPS and microphone permission are required for talkback. iOS autoplay restrictions, including Low Power Mode, can still require a manual Play/Resume tap. Network problems, Ring outages, camera session limits, and competing clients remain possible.

For installation, compatibility checks, diagnostics, and removal instructions, use the patch repository's guide. Keep its release separate from the Ring View card release.

Upstream status and retirement

Status checked 7 September 2026:

The intended permanent route is library fix → library release → Home Assistant dependency update. A merged library PR alone does not update an existing Home Assistant installation.

Once a Home Assistant release includes the corrected dependency, follow the patch repository's removal instructions and verify normal Live/reconnect behavior without the patch. Do not assume a particular future Home Assistant version is fixed until its dependency and release notes confirm it.

iPhone and playback troubleshooting