sphings-dev.de

Klingel und Briefkasten: Kamerabild per Telegram, Popup auf Tablets

Klingelt es, möchte ich sehen, wer vor der Tür steht, ohne ein Handy zu suchen. Und ich möchte wissen, wann Post eingeworfen und wann sie aus dem Briefkasten genommen wurde. Beides läuft über dasselbe Kamerabild der Einfahrt: Es geht als Foto in einen Telegram-Chat, und bei der Klingel erscheint es zusätzlich als Popup auf den Wandtablets.

Was du brauchst

  • Eine Kamera, die ein Standbild liefert (hier camera.einfahrt)
  • Die benutzerdefinierte Integration advanced_snapshot, die Schnappschüsse zuschneidet, beschriftet und als Datei ablegt
  • Die Integration Telegram Bot und je einen Chat für Klingel und Briefkasten
  • Eine Klingelanbindung, die den Helfer input_boolean.haustuer_klingel einschaltet. Wie das bei dir geschieht, hängt vom Aufbau ab
  • Zwei Kontaktsensoren am Briefkasten: einen an der Einwurfklappe, einen an der Tür zum Entnehmen der Post, dazu einen Helfer input_boolean.post_im_briefkasten
  • Wandtablets mit Browser, die über das HACS-Plugin browser_mod mit Home Assistant verbunden sind, und je einen Schalter für den Bildschirmschoner
  • Optional: ein Dashboard mit der Fernentriegelung des Türschlosses, auf das die Telegram-Nachricht verlinkt

So funktioniert es

Der Klingelhelfer ist ein input_boolean. Die Screenshot-Automation setzt ihn als Erstes wieder auf off. So erzeugt jedes weitere Klingeln eine neue Flanke für die beiden Automationen, die auf den Helfer lauschen. Danach wird der Schnappschuss gemacht: zugeschnitten auf den interessanten Bildbereich im Format 4:3, mit weißem Balken unten, links der Ort („Haustür“), rechts Datum und Uhrzeit.

Die Automation wartet nach dem Schnappschuss nicht. Der Dienst advanced_snapshot.take_snapshot ist awaitable: Das Script wartet, bis die Datei geschrieben ist (gemessen 1,35 Sekunden). Ob es geklappt hat, prüft die Automation an der Antwort. Der Dienst schluckt Fehler und meldet success: false, statt eine Ausnahme zu werfen. Ohne die Prüfung würde bei unerreichbarer Kamera still das vorherige, womöglich stundenalte Bild erneut gesendet. Klappt der Schnappschuss, geht das Foto mit „Es hat geklingelt!“ in den Chat, sonst nur der Text „Kamera nicht erreichbar – kein Bild“. Zuletzt kommt eine Nachricht mit einem Link zum Dashboard, auf dem sich die Tür öffnen lässt.

Beim Briefkasten sind es zwei Automationen. Die Klappe geht auf, wenn Post eingeworfen wird: Schnappschuss, Foto in den Briefkasten-Chat, Post-Merker an. Die Tür geht auf, wenn die Post herausgenommen wird: Schnappschuss, Foto, Post-Merker aus. Der Merker wird in beiden Fällen auch dann geschaltet, wenn das Bild fehlschlägt. Beide Trigger verlangen from: "off", damit ein Neustart mit offener Klappe oder Tür nicht aus unavailable oder unknown heraus auslöst. Jede Automation schreibt eine eigene Datei (briefkasten_klappe.jpg, briefkasten_tuer.jpg), um ein Wettrennen um den Dateinamen auszuschließen.

Die dritte Automation zeigt das Bild als Popup auf fünf Wandtablets in Küche, Wohnzimmer, Schlafzimmer, Kinderzimmer und Arbeitszimmer. Das Tablet am Eingang gehört bewusst nicht dazu, weil es direkt an der Tür steht. Zuerst wird der Bildschirmschoner ausgeschaltet, und zwar zweimal im Abstand von zwei Sekunden: Der REST-Server des Kiosk-Browsers verliert einzelne Befehle gelegentlich. Dann folgt ein eigener Schnappschuss und das Popup mit browser_mod.popup. Es schließt nach 45 Sekunden von selbst oder per Tipp auf das X und dann auf allen Tablets zugleich. Nach 55 Sekunden wird close_popup noch einmal gesendet, falls der Timeout-Dismiss wegen abgerissener browser_mod-Verbindung verloren ging. Zum Schluss geht der Bildschirmschoner wieder an.

Die Automation

Im Beispiel sind die Entitäten umbenannt. Die Telegram-Ziele stehen als notify.telegram_klingel und notify.telegram_briefkasten, die Adresse des Dashboards als Platzhalter. Bei browser_mod sind die Tablets im Beispiel über feste browser_id-Werte angesprochen statt über geräte-IDs.

alias: "Telegram Screenshot Kamera Einfahrt wenn es klingelt"
triggers:
  - {trigger: state, entity_id: input_boolean.haustuer_klingel, from: "off", to: "on"}
actions:
  - alias: Klingel-Helfer sofort zurücksetzen
    action: input_boolean.turn_off
    target: {entity_id: input_boolean.haustuer_klingel}
  - action: advanced_snapshot.take_snapshot
    alias: Schnappschuss
    response_variable: snapshot
    data:
      camera_entity_id: camera.einfahrt
      file_path: haustuer.jpg
      crop: [200, 0, 1000, 700]
      crop_aspect_ratio: "4:3"
      add_bar: true
      custom_text_left: Haustür
      custom_text_right: "{{ now().strftime('%d.%m.%y %H:%M:%S') }}"
      setting_font_path: Arial.ttf
      setting_font_size: auto
      setting_font_color: black
      setting_bar_height: 7%
      setting_bar_color: white
      setting_bar_position: bottom
  - alias: Foto nur senden, wenn der Schnappschuss wirklich geklappt hat
    if:
      - condition: template
        value_template: "{{ snapshot is mapping and snapshot.get('success', false) }}"
    then:
      - action: telegram_bot.send_photo
        data:
          file: "{{ snapshot.file_path }}"
          caption: "Es hat geklingelt!"
          entity_id: notify.telegram_klingel
    else:
      - action: telegram_bot.send_message
        data:
          message: "Es hat geklingelt! Kamera nicht erreichbar - kein Bild."
          entity_id: notify.telegram_klingel
  - action: telegram_bot.send_message
    data:
      message: "Tür öffnen? -> https://DEIN-HOME-ASSISTANT/dashboard-home/haustuer"
      parse_mode: html
      entity_id: notify.telegram_klingel
mode: single
max_exceeded: silent
alias: "Telegram Screenshot senden wenn der Briefkasten geöffnet wird"
triggers:
  - {trigger: state, entity_id: binary_sensor.briefkastenklappe_kontakt, from: "off", to: "on"}
actions:
  - action: advanced_snapshot.take_snapshot
    alias: Schnappschuss
    response_variable: snapshot
    data:
      camera_entity_id: camera.einfahrt
      file_path: briefkasten_klappe.jpg
      crop: [200, 0, 1000, 700]
      crop_aspect_ratio: "4:3"
      add_bar: true
      custom_text_left: Briefkasten
      custom_text_right: "{{ now().strftime('%d.%m.%y %H:%M:%S') }}"
      setting_font_path: Arial.ttf
      setting_font_size: auto
      setting_font_color: black
      setting_bar_height: 7%
      setting_bar_color: white
      setting_bar_position: bottom
  - alias: Foto nur senden, wenn der Schnappschuss wirklich geklappt hat
    if:
      - condition: template
        value_template: "{{ snapshot is mapping and snapshot.get('success', false) }}"
    then:
      - action: telegram_bot.send_photo
        data:
          file: "{{ snapshot.file_path }}"
          caption: "Der Briefkasten wurde geöffnet!"
          entity_id: notify.telegram_briefkasten
    else:
      - action: telegram_bot.send_message
        data:
          message: "Der Briefkasten wurde geöffnet! Kamera nicht erreichbar - kein Bild."
          entity_id: notify.telegram_briefkasten
  - alias: Post-Merker setzen (auch ohne Bild)
    action: input_boolean.turn_on
    target: {entity_id: input_boolean.post_im_briefkasten}
mode: single
max_exceeded: silent
alias: "Telegram Screenshot senden wenn der Briefkasten geleert wird"
triggers:
  - {trigger: state, entity_id: binary_sensor.briefkastentuer_kontakt, from: "off", to: "on"}
actions:
  - action: advanced_snapshot.take_snapshot
    alias: Schnappschuss
    response_variable: snapshot
    data:
      camera_entity_id: camera.einfahrt
      file_path: briefkasten_tuer.jpg
      crop: [200, 0, 1000, 700]
      crop_aspect_ratio: "4:3"
      add_bar: true
      custom_text_left: Briefkasten
      custom_text_right: "{{ now().strftime('%d.%m.%y %H:%M:%S') }}"
      setting_font_path: Arial.ttf
      setting_font_size: auto
      setting_font_color: black
      setting_bar_height: 7%
      setting_bar_color: white
      setting_bar_position: bottom
  - alias: Foto nur senden, wenn der Schnappschuss wirklich geklappt hat
    if:
      - condition: template
        value_template: "{{ snapshot is mapping and snapshot.get('success', false) }}"
    then:
      - action: telegram_bot.send_photo
        data:
          file: "{{ snapshot.file_path }}"
          caption: "Die Post wurde aus dem Briefkasten genommen!"
          entity_id: notify.telegram_briefkasten
    else:
      - action: telegram_bot.send_message
        data:
          message: "Die Post wurde aus dem Briefkasten genommen! Kamera nicht erreichbar - kein Bild."
          entity_id: notify.telegram_briefkasten
  - alias: Post-Merker löschen (auch ohne Bild)
    action: input_boolean.turn_off
    target: {entity_id: input_boolean.post_im_briefkasten}
mode: single
max_exceeded: silent
alias: "Klingel: Popup auf allen Wandtablets (browser_mod)"
triggers:
  - {trigger: state, entity_id: input_boolean.haustuer_klingel, from: ["off"], to: ["on"]}
actions:
  - action: switch.turn_off
    target: {entity_id: [switch.tablet_kueche_bildschirmschoner, switch.tablet_wohnzimmer_bildschirmschoner, switch.tablet_schlafzimmer_bildschirmschoner, switch.tablet_kinderzimmer_bildschirmschoner, switch.tablet_arbeitszimmer_bildschirmschoner]}
  - delay: {seconds: 2}
  - action: switch.turn_off      # doppelt gesendet: einzelne Befehle gehen gelegentlich verloren
    target: {entity_id: [switch.tablet_kueche_bildschirmschoner, switch.tablet_wohnzimmer_bildschirmschoner, switch.tablet_schlafzimmer_bildschirmschoner, switch.tablet_kinderzimmer_bildschirmschoner, switch.tablet_arbeitszimmer_bildschirmschoner]}
  - action: advanced_snapshot.take_snapshot
    alias: Schnappschuss
    response_variable: snapshot
    data:
      camera_entity_id: camera.einfahrt
      file_path: haustuer.jpg
      crop: [200, 0, 1000, 700]
      crop_aspect_ratio: "4:3"
      add_bar: true
      custom_text_left: Haustür
      custom_text_right: "{{ now().strftime('%d.%m.%y %H:%M:%S') }}"
      setting_font_path: Arial.ttf
      setting_font_size: auto
      setting_font_color: black
      setting_bar_height: 7%
      setting_bar_color: white
      setting_bar_position: bottom
  - action: browser_mod.popup
    data:
      browser_id: [tablet_kueche, tablet_wohnzimmer, tablet_schlafzimmer, tablet_kinderzimmer, tablet_arbeitszimmer]
      title: Klingel
      dismissable: true
      timeout: 45000
      timeout_hide_progress: false
      content:
        type: picture
        image: "/local/snapshots/haustuer.jpg?t={{ now().timestamp() | int }}"
      dismiss_action:
        service: browser_mod.close_popup
        data:
          browser_id: [tablet_kueche, tablet_wohnzimmer, tablet_schlafzimmer, tablet_kinderzimmer, tablet_arbeitszimmer]
          all: true
      timeout_action:
        service: browser_mod.close_popup
        data:
          browser_id: [tablet_kueche, tablet_wohnzimmer, tablet_schlafzimmer, tablet_kinderzimmer, tablet_arbeitszimmer]
          all: true
  - delay: {seconds: 55}
  - action: browser_mod.close_popup    # nochmals, falls der Timeout-Dismiss verloren ging
    data:
      browser_id: [tablet_kueche, tablet_wohnzimmer, tablet_schlafzimmer, tablet_kinderzimmer, tablet_arbeitszimmer]
      all: true
  - action: switch.turn_on
    target: {entity_id: [switch.tablet_kueche_bildschirmschoner, switch.tablet_wohnzimmer_bildschirmschoner, switch.tablet_schlafzimmer_bildschirmschoner, switch.tablet_kinderzimmer_bildschirmschoner, switch.tablet_arbeitszimmer_bildschirmschoner]}
mode: single

Anpassen

  • Passe den Bildausschnitt (crop) an deine Kamera an. Das Format 4:3 und der weiße Balken sind Geschmackssache.
  • Vergib den Tablets feste browser_id-Werte (Dienst browser_mod.change_browser_id). Zufällige IDs veralten bei jedem Neuverbinden.
  • Brauchst du kein Popup, lässt du die dritte Automation weg. Für das Popup nutzt du ein Bild unter /local/…, dazu gehört ein Ordner www in der Konfiguration.

Stolpersteine

Dateien unter /local sind in Home Assistant ohne Anmeldung abrufbar, wenn jemand die Adresse kennt. Das Bild wird mit einem Zeitstempel als Query-Parameter geladen, damit der Browser nicht die alte Datei zeigt. Die Klingel-Screenshot-Automation und die Popup-Automation schreiben beide nach haustuer.jpg und laufen bei einem Klingeln gleichzeitig. Bei den Briefkasten-Automationen habe ich die Dateinamen deshalb getrennt, hier nicht.

Außerdem verwendet das Popup bewusst das ältere service:-Schema in dismiss_action und timeout_action. Das Frontend von browser_mod kennt das neue perform_action-Schema dort nicht und zeigte darauf eine Fehlermeldung am Tablet.

Tags

Unterstützen

Diese Tools entstehen in meiner Freizeit und bleiben kostenlos, offen und cloud-frei. Wenn dir eins davon einen Nachmittag gespart hat, freue ich mich über einen Kaffee oder ein Stück Pizza.

Kaffee oder Pizza

Weitere Beiträge