Home Assistant integration

Vistralio publishes Home Assistant MQTT discovery topics automatically. Once your HA instance is connected to Vistralio's MQTT broker, every camera appears as a binary_sensor entity that flips ON when an event fires and OFF when the event ends.

Quick setup

1. In Home Assistant → Settings → Devices & Services → Add Integration → MQTT.
2. Broker: the Vistralio server's hostname or IP.
3. Port: 1883.
4. Username: sentinel.
5. Password: from /etc/vistralio/vistralio.yaml under mqtt.password.
6. Save.

That's it. Within a few seconds the entities will appear under MQTT.

Entity layout

Each camera becomes:

• binary_sensor.sentinel_cam<id> — on while an event is firing
• sensor.sentinel_cam<id>_last_label — the most recent label seen
• sensor.sentinel_cam<id>_last_score — confidence

Automation example

Flash the office lights when the warehouse driveway camera detects a person between 22:00 and 06:00:

alias: "Driveway intruder alert"
trigger:
  - platform: state
    entity_id: binary_sensor.sentinel_cam3
    to: "on"
condition:
  - condition: time
    after: "22:00:00"
    before: "06:00:00"
  - condition: template
    value_template: "{{ states('sensor.sentinel_cam3_last_label') == 'person' }}"
action:
  - service: light.turn_on
    target: { entity_id: light.office }
    data: { flash: long }

Disabling the discovery topics

If you don't use Home Assistant, the topics are harmless — they retain on the broker but consume essentially no resources. To stop publishing them, edit services/notifier.py and remove the homeassistant/... publish line.