advanced-camera-card/docs/configuration/conditions.md

conditions

conditions is not a top-level configuration block, but can be used as part of multiple other blocks.

Conditions are used to conditionally take action (in automations), to apply certain configurations (in overrides) or to display "picture elements" (in elements) depending on runtime evaluation.

[used as part of other configuration]
  conditions:
    - [condition_1]
    - [condition_2]

camera

conditions:
  - condition: camera
    # [...]

Parameter	Description
condition	Must be camera.
cameras	A list of camera IDs in which this condition is satisfied. See the camera id parameter.

expand

conditions:
  - condition: expand
    # [...]

Parameter	Description
condition	Must be expand.
expand	If true the condition is satisfied if the card is in expanded mode (in a dialog/popup). If false the condition is satisfied if the card is NOT in expanded mode (in a dialog/popup).

fullscreen

conditions:
  - condition: fullscreen
    # [...]

Parameter	Description
condition	Must be fullscreen.
fullscreen	If true the condition is satisfied if the card is in fullscreen mode. If false the condition is satisfied if the card is NOT in fullscreen mode.

interaction

conditions:
  - condition: interaction
    # [...]

Parameter	Description
condition	Must be interaction.
interaction	If true the condition is satisfied if the card has had human interaction within view.interaction_seconds elapsed seconds. If false the condition is satisfied if the card has NOT had human interaction in that time.

key

conditions:
  - condition: key
    # [...]

Parameter	Default	Description
condition	-	Must be key.
alt	false	An optional value to match whether the alt key is being held.
ctrl	false	An optional value to match whether the ctrl key is being held.
key		Any keyboard key value, e.g. ArrowLeft.
meta	false	An optional value to match whether the meta key is being held.
shift	false	An optional value to match whether the shift key is being held.
state	down	An optional value to match the state of the. Must be one of down or up.

media_loaded

conditions:
  - condition: media_loaded
    # [...]

Parameter	Description
condition	Must be media_loaded.
media_loaded	If true the condition is satisfied if there is media loadED (not loadING) in the card (e.g. a clip, snapshot or live view). This may be used to hide controls during media loading or when a message (not media) is being displayed.

microphone

conditions:
  - condition: microphone
    # [...]

Parameter	Description
condition	Must be microphone.
connected	Optional: If true or false the condition is satisfied if the microphone is connected or disconnected respectively.
muted	Optional: If true or false the condition is satisfied if the microphone is muted or unmuted respectively.

numeric_state

conditions:
  - condition: numeric_state
    # [...]

This stock Home Assistant condition works out of the box. See Home Assistant conditions documentation.

screen

conditions:
  - condition: screen
    # [...]

Parameter	Description
condition	Must be screen.
media_query	Any valid media query string. Media queries must start and end with parentheses. This may be used to alter card configuration based on device/media properties (e.g. viewport width, orientation). Please note that width and height refer to the entire viewport not just the card.

See the screen conditions examples.

state

conditions:
  - condition: state
    # [...]

This stock Home Assistant condition works out of the box. See Home Assistant conditions documentation.

triggered

conditions:
  - condition: triggered
    # [...]

Parameter	Description
condition	Must be triggered.
triggered	A list of camera IDs which, if triggered, satisfy the condition.

user

conditions:
  - condition: user
    # [...]

This stock Home Assistant condition works out of the box. See Home Assistant conditions documentation.

view

conditions:
  - condition: view
    # [...]

Parameter	Description
condition	Must be view.
views	A list of views in which this condition is satified (e.g. clips).

?> Internally, views associated with the media viewer (e.g. clip, snapshot, recording) are translated to a special view called media after the relevant media is fetched. When including views as part of a condition, you may need to refer to this special media view.

Fully expanded reference

conditions:
 - condition: camera
   cameras:
     - camera.office
  - condition: expand
    expand: true
  - condition: fullscreen
    fullscreen: true
  - condition: interaction
    interaction: true
  - condition: key
    alt: false
    ctrl: false
    key: F
    meta: false
    shift: false
    state: down
  - condition: media_loaded
    media_loaded: true
  - condition: microphone
    connected: true
    muted: true
  - condition: numeric_state
    entity: sensor.office_temperature
    above: 10
    below: 20
  - condition: screen
    media_query: '(orientation: landscape)'
  - condition: state
    entity: climate.office
    state: heat
    state_not: off
  - condition: triggered
    triggered:
      - camera.office
  - condition: user
    users:
      - 581fca7fdc014b8b894519cc531f9a04
  - condition: view
    views:
      - live