Verba Plugin profile

Camera Event

Capture a Home Assistant camera snapshot, describe it with vision AI, log the event, and optionally send Home Assistant phone/persistent notifications.

camera_event Version 1.2.0

When to use

Best-fit scenarios

Capture a Home Assistant camera snapshot, describe it with vision AI, log the event, and optionally send Home Assistant phone/persistent notifications.

How to call it

Execution guidance

Use the example call shape below and provide only the fields the plugin expects.

Arguments

Input shape

area string
front yard | back yard | garage | ...
camera string
camera.front_door_high
query string
optional hint for the vision model
title string
optional notification title override
priority string
critical|high|normal|low
cooldown_seconds integer
30
notification_cooldown_seconds integer
0
ignore_vehicles boolean
False
send_phone_alerts boolean
False
persistent_notifications boolean
False
api_notification boolean
True

Settings

Required configuration

DEFAULT_COOLDOWN_SECONDS number
Skip processing if the same camera fired recently.
Default: 30
DEFAULT_NOTIFICATION_TITLE string
Notification title used unless overridden in arguments.
Default: Camera Event
DEFAULT_PRIORITY select
critical/high map to high; normal/low map to normal for notifier delivery.
Default: high
ENABLE_HA_API_NOTIFICATION checkbox
If enabled, also send to the Home Assistant platform notification endpoint.
Default: True
ENABLE_PERSISTENT_NOTIFICATIONS checkbox
If enabled, send Home Assistant persistent notifications.
Default: False
ENABLE_PHONE_ALERTS checkbox
If enabled, send mobile alerts through Home Assistant Notifier.
Default: False
IGNORE_VEHICLES_DEFAULT select
If enabled, vehicle/car details are omitted from the vision description.
Default: false
MOBILE_NOTIFY_SERVICE string
Example: notify.mobile_app_my_iphone
MOBILE_NOTIFY_SERVICE_2 string
Optional additional Home Assistant mobile notify service.
MOBILE_NOTIFY_SERVICE_3 string
Optional additional Home Assistant mobile notify service.
MOBILE_NOTIFY_SERVICE_4 string
Optional additional Home Assistant mobile notify service.
MOBILE_NOTIFY_SERVICE_5 string
Optional additional Home Assistant mobile notify service.
NOTIFICATION_COOLDOWN_SECONDS number
Minimum seconds between Home Assistant notifier sends for the same camera. 0 disables this cooldown.
Default: 0
VISION_API_BASE string
OpenAI-compatible base (for example http://127.0.0.1:1234).
Default: http://127.0.0.1:1234
VISION_API_KEY string
Optional; leave blank for local stacks.
VISION_MODEL string
OpenAI-compatible vision model name.
Default: qwen2.5-vl-7b-instruct

Example call

Canonical usage JSON

{
  "function": "camera_event",
  "arguments": {
    "area": "front yard | back yard | garage | ...",
    "camera": "camera.front_door_high",
    "query": "optional hint for the vision model",
    "title": "optional notification title override",
    "priority": "critical|high|normal|low",
    "cooldown_seconds": 30,
    "notification_cooldown_seconds": 0,
    "ignore_vehicles": false,
    "send_phone_alerts": false,
    "persistent_notifications": false,
    "api_notification": true
  }
}

Back to Verba Plugins Platforms Kernel tools Cerberus