Zurück zum Blog

Klipper Push-Benachrichtigungen: Druckmeldungen aufs Handy

Klipper Push-Benachrichtigungen: Druckmeldungen aufs Handy

Ein zwölfstündiger Druck braucht nicht, dass du daneben stehst. Er braucht, dass du den Moment erfährst, in dem er fertig ist, und, noch wichtiger, den Moment, in dem er stoppt.

Klipper kann dir beides schon sagen. Moonraker, der API-Server hinter Mainsail und Fluidd, hat einen eingebauten Notifier, der bei Druckereignissen auslöst und sie über Apprise verschickt. Richte ihn auf einen Pocket Alert Webhook, und jeder fertige, fehlgeschlagene, abgebrochene oder pausierte Druck kommt als Push-Benachrichtigung auf dem Handy an. Kein Plugin, kein zusätzlicher Dienst auf dem Pi, ein Konfigurationsblock.

Was du brauchst

  • Einen Drucker mit Klipper und Moonraker. Wenn du Mainsail oder Fluidd im Browser öffnest, hast du Moonraker.
  • Ein kostenloses Pocket Alert-Konto und die App auf deinem iPhone oder Android-Handy.
  • Ungefähr fünf Minuten.

Schritt 1: Webhook in Pocket Alert anlegen

Öffne Webhooks im Dashboard und lege einen neuen an:

  • Name: den Drucker, zum Beispiel Voron 2.4. Der Name wird zum Push-Titel (Webhook Voron 2.4). Mit mehreren Druckern siehst du so auf einen Blick, welcher dich braucht.
  • Anwendung und Gerät: wohin die Benachrichtigung geht.
  • Nachricht: füge diese Vorlage ein:
%title%
%message%

Speichere und kopiere die Webhook-URL. Sie sieht so aus: https://p4a.me/wh/<your-webhook-id>.

Warum diese Vorlage: Moonraker übergibt jede Benachrichtigung an Apprise, und der JSON-Notifier von Apprise sendet eine kleine Nutzlast wie diese:

{
  "version": "1.0",
  "title": "❌ Print error",
  "message": "3DBenchy.gcode Move out of range: 235.000 0.000 0.200 [0.000]",
  "attachments": [],
  "type": "info",
  "level": "high"
}

Jedes %key% in der Vorlage wird durch das entsprechende Feld aus dem JSON ersetzt. Die Push-Benachrichtigung zeigt den Titel in der ersten Zeile und darunter die Meldung. Mehr zu Vorlagenpfaden unter Deine erste Webhook-URL erstellen.

Schritt 2: Notifier in moonraker.conf eintragen

Öffne moonraker.conf, in Mainsail unter Machine, in Fluidd unter Configuration, und füge diese drei Abschnitte am Ende ein. Ersetze YOUR_WEBHOOK_ID durch die ID aus deiner Webhook-URL.

[notifier pocketalert_done]
url: jsons://p4a.me/wh/YOUR_WEBHOOK_ID
events: complete
title: ✅ Print complete
body: {event_args[1].filename}

[notifier pocketalert_fail]
url: jsons://p4a.me/wh/YOUR_WEBHOOK_ID?:level=high
events: error, cancelled
title: ❌ Print {event_name}
body: {event_args[1].filename} {event_args[1].message}

[notifier pocketalert_pause]
url: jsons://p4a.me/wh/YOUR_WEBHOOK_ID?:level=high
events: paused
title: ⏸ Print paused
body: {event_args[1].filename}: check the printer

Was die einzelnen Teile tun:

  • jsons:// ist der JSON-Notifier von Apprise über HTTPS. Er sendet die Nutzlast von oben an deinen Webhook.
  • events legt fest, welche Druckzustände einen Abschnitt auslösen. Moonraker kennt started, complete, error, cancelled, paused und resumed.
  • ?:level=high weist Apprise an, "level": "high" in das JSON zu schreiben. Pocket Alert liest dieses Feld und sendet die Push-Benachrichtigung mit hoher Priorität. Auf dem iPhone kommt sie dann als zeitkritische Benachrichtigung und durchbricht Fokus-Modi. Der Abschnitt „complete“ hat kein Level und kommt deshalb als normale Push-Benachrichtigung an.
  • {event_args[1]} ist der Auftragszustand nach dem Ereignis. Er spiegelt das Objekt print_stats von Klipper wider: filename ist die G-Code-Datei, message ist Klippers Fehlertext, wenn ein Druck fehlschlägt.
  • {event_name} ist das ausgelöste Ereignis. So deckt ein Abschnitt sowohl error als auch cancelled ab, und der Titel sagt trotzdem, was passiert ist.

Schritt 3: Moonraker neu starten und testen

Starte Moonraker über das Energiemenü in Mainsail oder Fluidd neu oder per SSH:

sudo systemctl restart moonraker

Bevor du Filament für einen Test verbrauchst, prüfe den Webhook mit curl. Das sendet dieselbe JSON-Struktur, die auch Apprise verwendet:

curl -X POST https://p4a.me/wh/YOUR_WEBHOOK_ID \
  -H 'Content-Type: application/json' \
  -d '{"title":"❌ Print error","message":"test.gcode Move out of range","level":"high"}'

Wenn dein Handy vibriert, funktioniert die Pocket-Alert-Seite. Starte jetzt einen kleinen Druck und brich ihn nach der ersten Schicht ab. Du solltest innerhalb von Sekunden ❌ Print cancelled erhalten.

Was auf deinem Handy ankommt

Ein nächtlicher Fehldruck sieht auf dem Sperrbildschirm so aus:

Webhook Voron 2.4
❌ Print error
3DBenchy.gcode Move out of range: 235.000 0.000 0.200 [0.000]

Du weißt, welcher Drucker, welche Datei und warum er gestoppt hat, bevor du das Handy entsperrst.

Passe es an

Alles Folgende ist eine kleine Änderung in derselben Datei.

  • Druckstarts leise protokollieren. Füge einen Abschnitt mit events: started und ?:level=silent hinzu. Der Start wird im Nachrichtenverlauf festgehalten, ohne Ton.
  • Von Fehlern wecken lassen. Ändere ?:level=high im Fehlerabschnitt zu ?:level=critical. Auf Android durchbricht ein kritischer Alarm „Nicht stören“. Die kritische Zustellung ist ein kostenpflichtiges Feature. Im kostenlosen Tarif kommt die Nachricht trotzdem mit hoher Priorität an. Details unter kritische Alarme.
  • Mehrere Drucker. Ein Webhook pro Drucker, jeweils nach dem Gerät benannt. Der Push-Titel zeigt dir, welcher stehen geblieben ist.
  • Alarme aus deinen eigenen Makros. Moonraker hat auch ein gcode-Ereignis, sodass ein Klipper-Makro beliebigen Text senden kann. Nützlich für einen Filamentwechsel oder einen Runout-Sensor.

In moonraker.conf:

[notifier pocketalert_macro]
url: jsons://p4a.me/wh/YOUR_WEBHOOK_ID?:level=high
events: gcode
title: 🧵 Printer needs you
body: {event_message}

In printer.cfg:

[gcode_macro NOTIFY_FILAMENT_CHANGE]
gcode:
  {action_call_remote_method("notify",
                             name="pocketalert_macro",
                             message="Filament change needed")}

Rufe NOTIFY_FILAMENT_CHANGE aus deinem M600-Makro oder aus dem runout_gcode eines Filamentsensors auf.

Wenn nichts ankommt

  • Öffne den Webhook im Dashboard. Der Webhook-Verlauf zeichnet jeden Aufruf mit der rohen Nutzlast auf. Kein Eintrag bedeutet, dass Moonraker Pocket Alert nie erreicht hat. Ein Eintrag mit Fehler nennt dir den Grund.
  • Lies moonraker.log. Moonraker schreibt dort Notifier-Fehler hinein, zusammen mit der installierten Apprise-Version. Bei den meisten Installationen liegt sie unter ~/printer_data/logs/moonraker.log.
  • Leere Zeilen in der Push-Benachrichtigung. Die Vorlagenschlüssel müssen zur Apprise-Nutzlast passen: %title% und %message%, nicht %body%.

Warum kein Plugin?

Telegram-Bots und Fernzugriffsdienste für Klipper können mehr: Kamera-Snapshots, Timelapses, Fernsteuerung. Sie bringen aber auch einen weiteren Dienst auf dem Pi mit, den du installieren und aktuell halten musst. Wenn du nur willst, dass dir jemand sagt „Druck ist fertig“ und dich bei einem Fehler weckt, übernimmt Moonraker das Senden bereits. Pocket Alert muss es nur empfangen.

Und wenn der Drucker neben einem Homelab steht, landen seine Alarme in derselben App wie deine Server-, Backup- und Cronjob-Alarme, mit einem gemeinsamen Verlauf und denselben Prioritätsstufen.

FAQ

Muss ich etwas auf dem Raspberry Pi installieren?

Nein. Der Notifier ist Teil von Moonraker, und Apprise wird zusammen damit als Abhängigkeit installiert. Du bearbeitest nur moonraker.conf und startest Moonraker neu.

Funktioniert das mit Mainsail und Fluidd?

Ja. Beide sind Weboberflächen für Moonraker, und der Notifier lebt in Moonraker, daher ist die Einrichtung identisch. Du kannst moonraker.conf über beide bearbeiten.

Kann ich Benachrichtigungen von mehreren Druckern bekommen?

Ja. Lege pro Drucker einen Webhook an und benenne ihn nach dem Gerät. Der Webhook-Name wird zum Push-Titel.

Weckt mich ein fehlgeschlagener Druck nachts auf?

Mit level=high kommt die Push-Benachrichtigung auf dem iPhone als zeitkritisch an und durchbricht den Fokus. Um auf Android „Nicht stören“ zu durchbrechen, nutze level=critical in einem kostenpflichtigen Tarif.

Ist das kostenlos?

Ja. Webhooks funktionieren im kostenlosen Tarif, und jedes Ereignis verbraucht eine Nachricht aus deinem Tageslimit. Ein typischer Druck sendet ein bis zwei.

Webhook anlegen, die Konfiguration einfügen, und dein nächster Druck sagt dir, wann er fertig ist.

Artikel teilen