Reference¶

Complete behavior and field documentation for every part of the integration.

Core concepts¶

Profiles: A profile connects cameras to a notification target (your phone, a device group, a TV). Each profile has its own filters, templates, and phase settings. A camera can belong to multiple profiles, so you can layer different notification strategies on the same camera.

Global defaults & inheritance: Shared settings that profiles can inherit from. Each option in a profile can inherit the global value, override it, or disable it entirely. Set your baseline in the integration options flow (reconfigure any time), then only customize what differs per profile.

Presets: Starting templates that pre-fill a profile's configuration during the wizard. The integration ships with six (Live Alerts, Rich Alerts, End Only, Snapshot Only, Latest Only, Silent Log). All preset values are editable after profile creation.

Templates: Notification titles, messages, and subtitles are Jinja2 templates with access to 40+ context variables (camera name, detected objects, zones, severity, AI summaries, and more). Built-in templates cover common patterns; override at the profile or phase level for full control.

Filtering: Controls which reviews produce notifications. Filters cover object type, zone, severity, sub-labels, time of day, HA entity state, presence, cooldown, and more. Filters follow the same inheritance model as other profile settings.

All reference topics¶

Global Defaults -- shared settings that profiles inherit from
Profiles -- every profile field, entities, and device details
Presets -- built-in presets and custom YAML presets
Filtering -- the filter pipeline and profile inheritance model
Notification Lifecycle -- phases, dispatch, silence, and cooldown
Context Variables -- all template variables
Templates -- built-in templates, rendering, and notification URLs
Actions -- action buttons, tap actions, and custom HA actions
Logging -- filter rejection messages and key log entries