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

Conditions & triggers

Conditions and triggers are designed to mirror Home Assistant's own conditions and triggers as closely as possible: for the standard types Home Assistant's own documentation applies, and you can copy conditions and triggers straight out of an existing Home Assistant automation. The card adds a number of card-specific types, and is a little more permissive in places; any differences are noted per type below.

A trigger is what wakes an automation up. The moment a trigger fires, the card checks any conditions you have set, and if they all pass it runs the actions. The two therefore play different roles:

• A trigger is a momentary occurrence. Used only under triggers:, and only in automations.
• A condition is an ongoing predicate, true or false at a point in time. Besides gating automations (checked the instant a trigger fires), conditions also drive overrides and picture elements.

The same type can usually be used either way, but the meaning differs: as a condition it asks "is this true right now?"; as a trigger it fires "when this becomes true". A few types are restricted to one role (config is trigger-only; the composites and user / user_agent are condition-only), as noted at the top of each type below.

For the card-state types (camera, view, fullscreen, expand, call, display_mode, media_loaded, microphone, interaction, triggered) a trigger's value is optional: give it a value to fire only when the state changes to that value, or omit it to fire on any change. (The stock state trigger behaves the same way when from/to are omitted). As a condition the value keeps its usual per-type meaning, as described below.

# A trigger initiates an automation; conditions are then checked.
triggers:
  - [trigger_1]
conditions:
  - [condition_1]

Tip

Automation triggers are not the same as a camera's triggers. Automation triggers initiate automations; camera triggers take action on per-camera events such as motion. They share only the word "trigger".

Universal fields

Every condition and trigger accepts an optional enabled field, mirroring Home Assistant.

Parameter	Description
enabled	true (the default) keeps it active; false, or a template that renders falsey, skips it.

Note

An enabled template can turn a condition or trigger on or off at runtime: point it at an input_boolean (or any live value) and the change takes effect immediately, because the card re-evaluates enabled every time the condition is evaluated or trigger fires. This is an intentional extension: Home Assistant fixes enabled once when the automation loads, for both conditions and triggers.

Home Assistant's id, alias and variables keys are also accepted on any condition or trigger (so automations pasted from Home Assistant will validate), but will have no effect.

and

Condition only.

Evaluates to true if all embedded conditions evaluate to true. At least one condition is required.

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

Or, in shorthand form:

conditions:
  - and:
      # [...]

Parameter	Description
condition	Must be and.
conditions	A list of other conditions all of which must evaluate true in order for this condition to evaluate true.

call

Matches whether a two-way audio call is in progress. As a condition, true while the call state matches; as a trigger, fires when it becomes a match (e.g. call: true fires when a call starts).

# As a condition:
conditions:
  - condition: call
    call: true
# As a trigger:
triggers:
  - trigger: call
    call: true

Parameter	Description
condition / trigger	Must be call.
call	If true or false, matches when a two-way audio call is or is not in progress respectively.

camera

Matches the selected camera. As a condition, true while the selection matches; as a trigger, fires when the selection changes to a match. Does not match other cameras (whether visible or not).

# As a condition:
conditions:
  - condition: camera
    cameras: [front_door]
# As a trigger:
triggers:
  - trigger: camera
    cameras: [front_door]

Parameter	Description
condition / trigger	Must be camera.
cameras	An optional list of camera IDs. A list matches one of those cameras; omitted matches the presence of any selected camera (as a trigger: any selected camera change); [] matches when no camera is selected. See the camera id parameter.

config

Trigger only.

Fires when the card configuration changes (e.g. on startup, or when overrides are applied).

triggers:
  - trigger: config
    # [...]

Parameter	Description
trigger	Must be config.
paths	An optional list of configuration paths (e.g. menu.style). If provided, fires only when any of those paths changes; otherwise fires on any configuration change.

display_mode

Matches the card display mode (single or grid). As a condition, true while in that mode; as a trigger, fires when the display mode changes to it. See the display settings for live or media_viewer.

# As a condition:
conditions:
  - condition: display_mode
    display_mode: single
# As a trigger:
triggers:
  - trigger: display_mode
    display_mode: single

Parameter	Description
condition / trigger	Must be display_mode.
display_mode	Must be single or grid.

expand

Matches whether the card is in "expanded" mode (in a dialog/popup). As a condition, true while the mode matches; as a trigger, fires when it becomes a match.

# As a condition:
conditions:
  - condition: expand
    expand: true
# As a trigger:
triggers:
  - trigger: expand
    expand: true

Parameter	Description
condition / trigger	Must be expand.
expand	If true or false, matches when the card is or is not in expanded mode (in a dialog/popup) respectively.

fullscreen

Matches whether the card (or media within it) is in fullscreen mode. As a condition, true while the mode matches; as a trigger, fires when it becomes a match.

Warning

When fullscreen is entered via a video player's built-in controls (rather than the card's own fullscreen action or menu button), the browser fullscreens the video element itself rather than the card. Any automation action that replaces that video element (e.g. switching substreams) will immediately exit fullscreen. A partial workaround may be to use the card's fullscreen action instead. See Fullscreen with HD substream switching for an approach that combines substream switching with the card's fullscreen.

# As a condition:
conditions:
  - condition: fullscreen
    fullscreen: true
# As a trigger, on entering fullscreen:
triggers:
  - trigger: fullscreen
    fullscreen: true
# As a trigger, on any fullscreen change:
triggers:
  - trigger: fullscreen

Parameter	Description
condition / trigger	Must be fullscreen.
fullscreen	If true or false, matches when the card is or is not in fullscreen mode respectively.

initialized

Matches whether the card has finished initializing. As a condition, true once the card is initialized; as a trigger, fires when the card initializes (useful for running an automation on card start).

# As a condition:
conditions:
  - condition: initialized
# As a trigger:
triggers:
  - trigger: initialized

Parameter	Description
condition / trigger	Must be initialized.

interaction

Matches whether the card has recently been interacted with. As a condition, true while the interaction state matches; as a trigger, fires when it becomes a match.

# As a condition:
conditions:
  - condition: interaction
    interaction: true
# As a trigger:
triggers:
  - trigger: interaction
    interaction: true

Parameter	Description
condition / trigger	Must be interaction.
interaction	If true or false, matches when the card has or has not had human interaction within view.interaction_seconds elapsed seconds respectively.

key

Matches a keyboard key. As a condition, true while the key matches the given state; as a trigger, fires on the matching key event.

# As a condition:
conditions:
  - condition: key
    key: ArrowLeft
# As a trigger:
triggers:
  - trigger: key
    key: ArrowLeft

Parameter	Default	Description
condition / trigger	-	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 key. Must be one of down or up.

media_loaded

Matches whether the selected live or media stream has loaded. As a condition, true while the load state matches; as a trigger, fires when it becomes a match.

# As a condition:
conditions:
  - condition: media_loaded
    media_loaded: true
# As a trigger:
triggers:
  - trigger: media_loaded
    media_loaded: true

Parameter	Description
condition / trigger	Must be media_loaded.
media_loaded	If true or false, matches when there is or is not 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.

Note

Toggling a substream on or off does not cause this condition to transition. Substream is treated as a playback-layer detail of the same logical camera, so the condition remains satisfied while any stream of the camera continues to render.

microphone

Matches the microphone state. As a condition, true while the mute state matches; as a trigger, fires when it becomes a match.

# As a condition:
conditions:
  - condition: microphone
    muted: true
# As a trigger:
triggers:
  - trigger: microphone
    muted: true

Parameter	Description
condition / trigger	Must be microphone.
muted	If true or false, matches when the microphone is muted or unmuted respectively.

not

Condition only.

Evaluates to true if every embedded condition is false. At least one condition is required.

[!IMPORTANT] > not is a NOR operation, not a NAND. If any sub-condition is true, the not condition evaluates to false -- even if other sub-conditions are false. To pass, all sub-conditions must be false. This behavior matches the Home Assistant equivalent.

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

Or, in shorthand form:

conditions:
  - not:
      # [...]

Parameter	Description
condition	Must be not.
conditions	A list of other conditions none of which must evaluate true in order for this condition to evaluate true.

numeric_state

Matches a numeric Home Assistant value (an entity's state or attribute, or a template). As a condition, true while the value is within range; as a trigger, fires when the value crosses into range. At least one of above / below is required.

# As a condition:
conditions:
  - condition: numeric_state
    entity: sensor.office_temperature
    above: 10
    below: 20
# As a trigger:
triggers:
  - trigger: numeric_state
    entity_id: sensor.office_temperature
    above: 10
    below: 20

Parameter	Description
condition / trigger	Must be numeric_state.
entity / entity_id	The entity (or list of entities) to read.
above	Match when the value is above this: a number, or an entity ID whose state supplies the threshold.
below	Match when the value is below this: a number, or an entity ID whose state supplies the threshold.
value_template	A template whose rendered numeric value is compared instead of the entity's state.
attribute	Compare this attribute instead of the entity's state.
for	Trigger only. A duration (hh:mm:ss or a template) the value must stay in range before firing.

See the Home Assistant numeric_state condition and numeric_state trigger.

or

Condition only.

Evaluates to true if any embedded condition evaluates to true. At least one condition is required.

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

Or, in shorthand form:

conditions:
  - or:
      # [...]

Parameter	Description
condition	Must be or.
conditions	A list of conditions any of which must evaluate true in order for this condition to evaluate true.

screen

Matches a CSS media query. As a condition, true while the query matches; as a trigger, fires when the match changes (e.g. on a change of orientation or viewport size).

# As a condition:
conditions:
  - condition: screen
    media_query: '(orientation: landscape)'
# As a trigger:
triggers:
  - trigger: screen
    media_query: '(orientation: landscape)'

Parameter	Description
condition / trigger	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

Matches a Home Assistant entity's state. Unlike most types, the condition and trigger forms take different fields: a condition compares the current value (requiring state or state_not), while a trigger matches the transition (from / to, both optional).

Both forms accept entity (or its entity_id alias) as a single entity or a list.

As a condition

conditions:
  - condition: state
    entity: binary_sensor.door
    state: 'on'

Parameter	Description
condition	Must be state.
entity / entity_id	The entity (or list of entities) to check.
state	A state, or list of states, the entity must match.
state_not	A state, or list of states, the entity must not match.
match	With a list of entities: all (the default) requires every entity to match, any requires at least one.
for	A duration (hh:mm:ss or a template) the match must have held.
attribute	Compare this attribute instead of the entity's state.

See the Home Assistant state condition.

As a trigger

triggers:
  - trigger: state
    entity_id: binary_sensor.door
    to: 'on'

Parameter	Description
trigger	Must be state.
entity / entity_id	The entity (or list of entities) to watch.
from / not_from	Match (or exclude) the prior state. A single value, a list, or null (any).
to / not_to	Match (or exclude) the new state. A single value, a list, or null (any).
for	A duration (hh:mm:ss or a template) the new state must hold before firing.
attribute	Watch this attribute instead of the entity's state.

See the Home Assistant state trigger.

template

Matches a Home Assistant template. As a condition, true while the template renders true; as a trigger, fires when it changes from non-true to true.

# As a condition:
conditions:
  - condition: template
    value_template: "{{ states('switch.office') == 'on' }}"
# As a trigger:
triggers:
  - trigger: template
    value_template: "{{ states('switch.office') == 'on' }}"

Parameter	Description
condition / trigger	Must be template.
value_template	The Home Assistant template to evaluate, e.g. {{ states('switch.office') == 'on' }}.
for	Trigger only. A duration (hh:mm:ss or a template) the template must stay true before firing.

See the Home Assistant template condition and template trigger.

Note

In order to match native Home Assistant behavior, condition and trigger truthiness differ: a condition passes only when the template renders true (case-insensitive), whereas a trigger also accepts broader truthy values (1, yes, on, enable).

Note

A trigger is re-evaluated when card or Home Assistant state changes, not on a timer, so a template that depends only on time (e.g. {{ now().hour == 8 }}) will not fire on its own.

Tip

The Advanced Camera Card uses ha-nunjucks to process templates. Consult its documentation for the wide variety of different template values supported.

triggered

Matches the set of cameras currently triggered. As a condition, true while the set matches; as a trigger, fires when it becomes a match.

# As a condition:
conditions:
  - condition: triggered
    triggered: [camera.office]
# As a trigger:
triggers:
  - trigger: triggered
    triggered: [camera.office]

Parameter	Description
condition / trigger	Must be triggered.
triggered	An optional list of camera IDs. Matches when one of them is triggered. Omit to match while any camera is triggered; use an empty list [] to match while none is.

user

Condition only.

Matches the logged-in Home Assistant user. See the Home Assistant user condition.

conditions:
  - condition: user
    users:
      - 581fca7fdc014b8b894519cc531f9a04

Parameter	Description
condition	Must be user.
users	A list of Home Assistant user IDs to match.

user_agent

Condition only.

Matches the User-Agent.

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

Parameter	Description
condition	Must be user_agent.
user_agent	Exactly matches a user-agent, e.g. Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36
user_agent_re	Matches a user-agent based on a regular expression, e.g. Chrome/.
casting	If true matches if the card is being cast to a Chromecast / TV device, if false matches if the card is NOT being cast.
companion	If true matches if the user-agent is the Home Assistant companion app, if false matches if the user-agent is NOT the Home Assistant companion app.

At least one of these parameters is required. When multiple are specified they must all match for the condition to match.

See the user-agent overrides example.

view

Matches the selected view. As a condition, true while a matching view is selected; as a trigger, fires when the selected view changes to a matching one.

# As a condition:
conditions:
  - condition: view
    views: [live]
# As a trigger:
triggers:
  - trigger: view
    views: [live]

Parameter	Description
condition / trigger	Must be view.
views	A list of views to match (e.g. clips). Required as a condition; optional as a trigger (omit to fire on any view change).

Important

Internally, views associated with the media viewer (e.g. clip, snapshot, review, recording) are translated to the media view after the relevant media is fetched. When naming views in a condition or trigger, you may need to refer to the media view.

Unsupported Home Assistant conditions and triggers

Several Home Assistant condition types are not currently supported: time, zone, sun, location, device, and condition: trigger (matching on the id of the trigger that fired).

On the trigger side, only the stock state, numeric_state and template platforms are supported, alongside the card-specific triggers listed above. Other Home Assistant trigger platforms -- including event, time, time_pattern, sun, zone, calendar, webhook, tag, device and mqtt -- are not supported.

If you need any of these, please open an issue.

Fully expanded reference

Conditions

conditions:
  - and:
      - condition: camera
        cameras: [front_door]
      - condition: view
        views: [live]
  - condition: call
    call: true
  - condition: camera
    cameras:
      - camera.office
  - condition: display_mode
    display_mode: single
  - condition: expand
    expand: true
  - condition: fullscreen
    fullscreen: true
  - condition: initialized
  - 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
    muted: true
  - not:
      - condition: fullscreen
        fullscreen: true
  - condition: numeric_state
    entity: sensor.office_temperature
    above: 10
    below: 20
  - or:
      - condition: camera
        cameras: [front_door]
      - condition: view
        views: [live]
  - condition: screen
    media_query: '(orientation: landscape)'
  - condition: state
    entity: climate.office
    state: heat
    state_not: 'off'
  - condition: template
    value_template: "{{ is_state('switch.office', 'on') }}"
  - condition: triggered
    triggered:
      - camera.office
  - condition: user
    users:
      - 581fca7fdc014b8b894519cc531f9a04
  - condition: user_agent
    user_agent: 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36'
    user_agent_re: 'Chrome/'
    casting: true
    companion: true
  - condition: view
    views:
      - live

Triggers

triggers:
  - trigger: call
    call: true
  - trigger: camera
    cameras:
      - camera.office
  - trigger: config
    paths:
      - 'menu.style'
  - trigger: display_mode
    display_mode: single
  - trigger: expand
    expand: true
  - trigger: fullscreen
    fullscreen: true
  - trigger: initialized
  - trigger: interaction
    interaction: true
  - trigger: key
    alt: false
    ctrl: false
    key: F
    meta: false
    shift: false
    state: down
  - trigger: media_loaded
    media_loaded: true
  - trigger: microphone
    muted: true
  - trigger: numeric_state
    entity_id: sensor.office_temperature
    above: 10
    below: 20
    for: '00:00:05'
  - trigger: screen
    media_query: '(orientation: landscape)'
  - trigger: state
    entity_id: climate.office
    from: 'off'
    to: heat
    for: '00:00:05'
  - trigger: template
    value_template: "{{ is_state('switch.office', 'on') }}"
    for: '00:00:05'
  - trigger: triggered
    triggered:
      - camera.office
  - trigger: view
    views:
      - live