diff --git a/README.md b/README.md index 8bf94de0..33bde4e8 100644 --- a/README.md +++ b/README.md @@ -24,6 +24,7 @@ A full-featured Frigate Lovelace card: * Support for filtering events by zone and label. * Motion sensor access. * Full Lovelace editing support. +* Theme friendly. * **Advanced**: Support for [WebRTC](https://github.com/AlexxIT/WebRTC) live viewing. ## Installation @@ -75,6 +76,7 @@ lovelace: | `motion_entity` | | A binary sensor to show in the menu (e.g. a Frigate motion binary sensor) and to use to trigger card updates.| | `frigate_camera_name` | The string after the "camera." in the `camera_entity` option (above). | This parameter allows the camera name heuristic to be overriden for cases where the entity name does not cleanly map to the Frigate camera name.| | `view_default` | `live` | The view to show by default. See [views](#views) below.| +| `menu_mode` | `hidden` | The menu mode to show by default. See [menu modes](#menu-modes) below.| | `view_timeout` | | A numbers of seconds of inactivity after which the card will reset to the default configured view. Inactivity is defined as lack of interaction with the Frigate menu.| | `autoplay_clip` | `false` | Whether or not to autoplay clips in the 'clip' [view](#views). Clips manually chosen in the clips gallery will still autoplay.| @@ -105,9 +107,11 @@ Note: WebRTC must be installed and configured separately (see [details](https:// ## Views +This card supports several different views. + | Key | Description | | ------------- | --------------------------------------------- | -|`live`| Shows the live camera view, either the name Frigate view or [WebRTC](#webrtc) if configured.| +|`live` (default)| Shows the live camera view, either the name Frigate view or [WebRTC](#webrtc) if configured.| |`snapshots`|Shows the snapshot gallery for this camera/zone/label.| |`snapshot`|Shows the most recent snapshot for this camera/zone/label.| |`clips`|Shows the clip gallery for this camera/zone/label.| @@ -115,6 +119,19 @@ Note: WebRTC must be installed and configured separately (see [details](https:// For the `clip` or `snapshot` view, the most recent clip/snapshot is rendered. This will automatically update whenever the state of the `camera_entity` or `motion_entity` changes. In particular, if the desire is to have a live view of the most recent event, you should configure `motion_entity` to a Frigate binary sensor associated with that camera in order to trigger updates more regularly (the underlying camera entity state does not change often, the motion binary sensors do). + +## Menu Modes + +This card supports several menu configurations. + +| Key | Description | Screenshot | +| ------------- | --------------------------------------------- | - | +|`hidden` (default)| Hide the menu by default, expandable upon clicking the 'F' button. | Menu hidden | +|`overlay`| Overlay the menu on top of the card contents. The 'F' button shows the default view. | Menu overlaid | +|`above`| Render the menu above the card. The 'F' button shows the default view. | Menu above | +|`below`| Render the menu below the card. The 'F' button shows the default view. | Menu below | + + ### Example YAML Configuration diff --git a/images/menu-mode-above.png b/images/menu-mode-above.png new file mode 100644 index 00000000..f92c5ab2 Binary files /dev/null and b/images/menu-mode-above.png differ diff --git a/images/menu-mode-below.png b/images/menu-mode-below.png new file mode 100644 index 00000000..ea231a96 Binary files /dev/null and b/images/menu-mode-below.png differ diff --git a/images/menu-mode-hidden.png b/images/menu-mode-hidden.png new file mode 100644 index 00000000..591b4066 Binary files /dev/null and b/images/menu-mode-hidden.png differ diff --git a/images/menu-mode-overlay.png b/images/menu-mode-overlay.png new file mode 100644 index 00000000..4a403182 Binary files /dev/null and b/images/menu-mode-overlay.png differ