Skip to content

Actions

Jump to bottom
Mark Parker edited this page Oct 26, 2026 · 1 revision

Whilst VACA is primarily designed to work with View Assist, we recognise that some people like to roll their own things. As such, we have created a new action feature that allows you to:

  • Navigate the webview
  • Control the alarm
  • Display toast messages
  • Refresh the webview
  • Issue a wake word detection
  • Interrupt responses
  • Get logcat logs

These features are designed for advanced users and may not be simple to understand. However, feel free to reach out for help on our discord.

Navigate the webview

You can issue a full url or just a path. If jus a path, it will navigate within the HA server.

action: vaca.send_event
target:
  device_id: [YOUR DEVICE]
data:
  event_name: navigate
  event_value:
    url: /lovelace/0

Control the alarm

Turns the alarm sounder on or off.

action: vaca.send_event
target:
  device_id: [YOUR DEVICE]
data:
  event_name: alarm
  event_value:
    activate: true

Display toast messages

These messages will apear on a toast popup on the screen for a short time.

action: vaca.send_event
target:
  device_id: [YOUR DEVICE]
data:
  event_name: toast-message
  event_value:
    message: This is a test message!

Refresh the webview

action: vaca.send_event
target:
  device_id: [YOUR DEVICE]
data:
  event_name: refresh

Issue a wake word detection

action: vaca.send_event
target:
  device_id: [YOUR DEVICE]
data:
  event_name: wake

Interrupt response

action: vaca.send_event
target:
  device_id: [YOUR DEVICE]
data:
  event_name: interrupt

Get logcat logs

Will retrieve the current logcat logs for this app and save to a file in the config/vaca folder of your HA server. This is to allow easy sending of logs when raising an issue.

action: vaca.send_event
target:
  device_id: [YOUR DEVICE]
data:
  event_name: get-logs
  event_value:
    lines: 5000

Clone this wiki locally