diff --git a/README.md b/README.md index 46c052f0..9a9900a9 100644 --- a/README.md +++ b/README.md @@ -951,6 +951,14 @@ View events in the timeline. Event Timeline + + +### Card Casting + +A dashboard with the card can be cast onto a suitable device (such as the Nest Hub shown below). + +Card on Nest Hub + ## Examples ### Illustrative Expanded Configuration Reference @@ -2514,6 +2522,33 @@ view: timeout_seconds: 30 ``` +### Casting the Card + +This card can be (Chrome) casted to a device (such as a [Nest Hub](https://store.google.com/us/product/nest_hub_2nd_gen)) through the use of [Home Assistant Cast](https://cast.home-assistant.io/). + +#### Limitations + +Casting Home Assistant dashboards comes with a number of caveats: + +* Home Assistant Casting does not support the HA `streaming` component ([source](https://cast.home-assistant.io/faq.html)). This means clips playing and the `ha` live provider can not work. Other live providers such as `jsmpeg` and `webrtc-card` function correctly. +* The Javascript fullscreen API does not work (so the fullscreen button does not work, but see below for an equivalent). + +#### Recommended configuration for a Nest Hub + +Using a `panel` dashboard with the following base configuration will result in the card consuming the entire device screen: + +```yaml +type: custom:frigate-card +cameras: + - camera_entity: camera.front_door + live_provider: frigate-jsmpeg +dimensions: + aspect_ratio: 1024:600 + aspect_ratio_mode: static +``` + +See [screenshot above](#screenshots-card-casting). + ## Troubleshooting diff --git a/images/card-on-nest-hub.jpg b/images/card-on-nest-hub.jpg new file mode 100644 index 00000000..7a911edb Binary files /dev/null and b/images/card-on-nest-hub.jpg differ