From bad737994d9cc683dc22b504ead43aeeb8c727d5 Mon Sep 17 00:00:00 2001 From: Dermot Duffy Date: Mon, 3 Mar 2025 21:10:06 -0800 Subject: [PATCH] docs: Highlight and improve help for duplicate versions (#1935) --- docs/troubleshooting.md | 29 ++++++++++++++++++----------- 1 file changed, 18 insertions(+), 11 deletions(-) diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md index 8631d495..b202df51 100644 --- a/docs/troubleshooting.md +++ b/docs/troubleshooting.md @@ -2,6 +2,24 @@ ## Highlighted Issues +### Duplicate versions / Duplicate element registrations / `Custom element not found: advanced-camera-card` + +If your card appears to not load anymore (but was working previously), you're +seeing the version of the card changing between reloads, or seeing log entries +like: + +`Failed to execute 'define' on 'CustomElementRegistry': the name "focus-trap" has already been used with this registry window` + +Verify that your dashboard resources contain only a single instance of the card +(for HACS users, you should see only `/hacsfiles/advanced-camera-card/`. If you +_also_ see `/hacsfiles/frigate-card/`, remove it, clear your caches and reload). + +Steps: + +1. Edit your dashboard -> (Three dots menu) -> `Manage Resources`. Remove any line item that refers to `frigate-hass-card`. You should only have a single row entry for `advanced-camera-card`. +1. [Optionally] You can delete the frigate-hass-card directory on your filesystem if present, e.g. `$HA_PATH/www/community/frigate-hass-card`, as long as it has an `advanced-camera-card` directory there too. +1. Clear all your caches. + ### Stream does not load Stream not loading? Permanent "loading circle"? @@ -168,17 +186,6 @@ documentation](https://docs.frigate.video/frigate/installation#docker). Large downloads may take a few seconds to assemble, so there may be a delay between clicking the download button and the download starting. -### Duplicate versions / Duplicate element registrations - -You're seeing the version of the card changing between reloads, or seeing -log entries like: - -`Failed to execute 'define' on 'CustomElementRegistry': the name "focus-trap" has already been used with this registry window` - -Verify that your dashboard resources contain only a single instance of the card -(for HACS users, you should see only `/hacsfiles/advanced-camera-card/`. If you -_also_ see `/hacsfiles/frigate-card/`, remove it, clear your caches and reload). - ### `Forbidden media source identifier` - If you are using a custom `client_id` setting in your `frigate.yml` file (the