flan/advanced-camera-card

Fork 0

Files

T

Dermot Duffy e503f0e429 Initial version of status bar.

2024-08-16 20:08:21 -07:00

17 KiB

Raw Blame History

Custom Elements

`conditional`

Restrict a set of elements to only render when the card is matches a set of conditions. This is analogous to the stock conditional element except supporting a rich set of Frigate Card conditions.

elements:
  - type: custom:frigate-card-conditional
    # [...]

Parameters for the custom:frigate-card-conditional element:

Parameter	Description
`type`	Must be `custom:frigate-card-conditional`.
`conditions`	A list of conditions that must evaluate to true in order for the elements to be rendered.
`elements`	The elements to render. Can be any supported element.

See the conditional elements example.

`menu-icon`

Add an arbitrary icon to the Frigate Card menu. Configuration is ~identical to that of the Picture Elements Icon except with a type name of custom:frigate-card-menu-icon.

elements:
  - type: custom:frigate-card-menu-icon
    # [...]

`menu-submenu`

Add a configurable submenu dropdown.

elements:
  - type: custom:frigate-card-menu-submenu
    # [...]

Parameters for this element are identical to the parameters of the stock Home Assistant Icon Element with the exception of these parameters which differ:

Parameter	Description
`type`	Must be `custom:frigate-card-menu-submenu`.
`items`	A list of menu items, as described below.

Submenu items

Parameter	Default	Description
`enabled`	`true`	Whether or not to show this item as enabled / selectable.
`entity`		An optional Home Assistant entity from which title, icon and style can be automatically computed.
`icon`		An optional item icon to display, e.g. `mdi:car`
`selected`	`false`	Whether or not to show this item as selected.
`state_color`	`true`	Whether or not the title and icon should be stylized based on state.
`style`		Position and style the element using CSS.
`tap_action`, `double_tap_action`, `hold_action`, `start_tap`, `end_tap`		The actions to take when this item is interacted with.
`title`		An optional title to display.

`menu-submenu-select`

Add a submenu based on a select or input_select. This element allows you to convert a Home Assistant Select Entity or Home Assistant Input Select Entity (an entity either starting with select or input_select) into an overridable submenu. This could be done by hand using a regular submenu (above) -- this element is a convenience.

elements:
  - type: custom:frigate-card-menu-submenu-select
    # [...]

Parameters for the custom:frigate-card-menu-submenu-select element are identical to the parameters of the stock Home Assistant State Icon Element with the exception of these parameters which differ:

Parameter	Description
`type`	Must be `custom:frigate-card-menu-submenu-select`.
`options`	An optional dictionary of overrides keyed by the option name that the given select entity supports. These options can be used to set or override submenu item parameters on a per-option basis. The format is as described in Submenu Items above.

See the select submenu example.

`state-icon`

Add a state icon to the Frigate Card menu that represents the state of a Home Assistant entity. Configuration is ~identical to that of the Picture Elements State Icon except with a type name of custom:frigate-card-menu-state-icon.

elements:
  - type: custom:frigate-card-menu-icon
    # [...]

`status-bar-icon`

Add an arbitrary icon to the status bar.

elements:
  - type: custom:frigate-card-status-bar-icon
    # [...]

Parameter	Default	Description
`type`		Must be `custom:frigate-card-status-bar-icon`.
`actions`		Actions to performs when the status bar item is interacted with. See actions.
`enabled`	`true`	`true` to enable this status bar item, `false` to disable.
`exclusive`	`false`	Whether or not this item should evict non-exclusive items from the status bar.
`expand`	`false`	If `false` this status bar item will consume the minimum possible space, if `true` will expand to the available space.
`icon`		The icon to show in the status bar, e.g. `mdi:camera-front`.
`priority`	`50`	The item priority. Higher priority items are ordered closer to the start of the status bar (i.e. an item with priority `70` will order further to the left than an item with priority `60`). Minimum `0`, maximum `100`.
`sufficient`	`false`	Whether or not this item is sufficient to display the status bar if it's otherwise hidden (e.g. with the `popup` status bar style).

`status-bar-image`

Add an arbitrary image to the status bar.

elements:
  - type: custom:frigate-card-status-bar-image
    # [...]

Parameter	Default	Description
`type`		Must be `custom:frigate-card-status-bar-image`.
`actions`		Actions to performs when the status bar item is interacted with. See actions.
`enabled`	`true`	`true` to enable this status bar item, `false` to disable.
`exclusive`	`false`	Whether or not this item should evict non-exclusive items from the status bar.
`expand`	`false`	If `false` this status bar item will consume the minimum possible space, if `true` will expand to the available space.
`image`		The image to show in the status bar, e.g. `https://my.site.com/status.png`.
`priority`	`50`	The item priority. Higher priority items are ordered closer to the start of the status bar (i.e. an item with priority `70` will order further to the left than an item with priority `60`). Minimum `0`, maximum `100`.
`sufficient`	`false`	Whether or not this item is sufficient to display the status bar if it's otherwise hidden (e.g. with the `popup` status bar style).

`status-bar-string`

Add an arbitrary string to the status bar.

elements:
  - type: custom:frigate-card-status-bar-string
    # [...]

Parameter	Default	Description
`type`		Must be `custom:frigate-card-status-bar-string`.
`actions`		Actions to performs when the status bar item is interacted with. See actions.
`enabled`	`true`	`true` to enable this status bar item, `false` to disable.
`exclusive`	`false`	Whether or not this item should evict non-exclusive items from the status bar.
`expand`	`false`	If `false` this status bar item will consume the minimum possible space, if `true` will expand to the available space.
`string`		The string to show in the status bar, e.g. `Intruder detected!`
`priority`	`50`	The item priority. Higher priority items are ordered closer to the start of the status bar (i.e. an item with priority `70` will order further to the left than an item with priority `60`). Minimum `0`, maximum `100`.
`sufficient`	`false`	Whether or not this item is sufficient to display the status bar if it's otherwise hidden (e.g. with the `popup` status bar style).

Fully expanded reference

Actions are omitted for simplicity.

elements:
  - type: custom:frigate-card-menu-icon
    icon: mdi:car
    title: Vroom
  - type: custom:frigate-card-menu-state-icon
    entity: light.office_main_lights
    title: Office lights
    icon: mdi:chair-rolling
    state_color: true
  - type: custom:frigate-card-menu-submenu
    icon: mdi:menu
    items:
      - title: Lights
        icon: mdi:lightbulb
        entity: light.office_main_lights
        tap_action:
          action: toggle
      - title: Google
        icon: mdi:google
        enabled: false
        tap_action:
          action: url
          url_path: https://www.google.com
  - type: custom:frigate-card-menu-submenu-select
    icon: mdi:lamps
    entity: input_select.kitchen_scene
    options:
      scene.kitchen_cooking_scene:
        icon: mdi:chef-hat
        title: Cooking time!
      scene.kitchen_tv_scene:
        icon: mdi:television
        title: TV!
    # Show a pig icon if a variety of conditions are met.
  - type: custom:frigate-card-conditional
    elements:
      - type: icon
        icon: mdi:pig
        title: Oink
        style:
          left: 300px
          top: 100px
    conditions:
      - condition: view
        views:
          - live
      - condition: fullscreen
        fullscreen: true
      - condition: expand
        expand: true
      - condition: camera
        cameras: camera.front_door
      - condition: media_loaded
        media_loaded: true
      - condition: display_mode
        display_mode: single
      - condition: triggered
        triggered:
          - camera.front_door
      - condition: interaction
        interaction: true
      - condition: microphone
        muted: true
        connected: true
      - condition: state
        entity: light.office_main_lights
        state: on
        state_not: off
      - condition: numeric_state
        entity: sensor.light_level
        above: 20
        below: 100
      - condition: user
        users:
          - 581fca7fdc014b8b894519cc531f9a04
  - type: custom:frigate-card-status-bar-string
    enabled: true
    exclusive: false
    expand: false
    string: 'Intruder alert!'
    priority: 50
    sufficient: false
  - type: custom:frigate-card-status-bar-icon
    enabled: true
    exclusive: false
    expand: false
    icon: 'mdi:cow'
    priority: 50
    sufficient: false
  - type: custom:frigate-card-status-bar-image
    enabled: true
    exclusive: false
    expand: false
    image: https://my.site.com/status.png
    priority: 50
    sufficient: false

17 KiB Raw Blame History

Custom Elements

conditional

menu-icon

menu-submenu

Submenu items

menu-submenu-select

state-icon

status-bar-icon

status-bar-image

status-bar-string