Notifiche push per Klipper: avvisi di stampa sul telefono

Una stampa da dodici ore non ha bisogno che tu le stia accanto. Ha bisogno che tu sappia nel momento in cui finisce e, cosa più importante, nel momento in cui si ferma.
Klipper può già segnalarti entrambe le cose. Moonraker, il server API alla base di Mainsail e Fluidd, ha un notifier integrato che si attiva sugli eventi di stampa e li invia tramite Apprise. Puntalo a un webhook di Pocket Alert e ogni stampa completata, fallita, annullata o messa in pausa arriva sul tuo telefono come notifica push. Nessun plugin, nessun servizio extra sul Pi, un solo blocco di configurazione.
Cosa ti serve
- Una stampante con Klipper e Moonraker. Se apri Mainsail o Fluidd nel browser, hai già Moonraker.
- Un account Pocket Alert gratuito e l'app sul tuo telefono iPhone o Android.
- Circa cinque minuti.
Passo 1. Crea un webhook in Pocket Alert
Apri Webhook nella dashboard e creane uno nuovo:
- Nome: la stampante, per esempio
Voron 2.4. Il nome diventa il titolo della notifica push (Webhook Voron 2.4), così, con più stampanti, vedi a colpo d'occhio quale ha bisogno di te. - Applicazione e Dispositivo: dove deve arrivare la notifica.
- Messaggio: incolla questo modello:
%title%
%message%
Salva e copia l'URL del webhook. Ha questo aspetto: https://p4a.me/wh/<your-webhook-id>.
Perché questo modello: Moonraker passa ogni notifica ad Apprise, e il notifier JSON di Apprise invia un payload di questo tipo:
{
"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"
}
Ogni %key% nel modello viene sostituito con il campo corrispondente del JSON. La notifica mostra il titolo sulla prima riga e il messaggio sotto. Per saperne di più sui percorsi dei modelli, leggi Crea il tuo primo URL webhook.
Passo 2. Aggiungi i notifier a moonraker.conf
Apri moonraker.conf (in Mainsail sotto Machine, in Fluidd sotto Configuration) e aggiungi in fondo queste tre sezioni. Sostituisci YOUR_WEBHOOK_ID con l'ID presente nell'URL del tuo webhook.
[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
Cosa fa ciascuna parte:
jsons://è il notifier JSON di Apprise su HTTPS. Invia il payload mostrato sopra al tuo webhook.eventssceglie gli stati di stampa che attivano una sezione. Moonraker riconoscestarted,complete,error,cancelled,pausederesumed.?:level=highdice ad Apprise di aggiungere"level": "high"al JSON. Pocket Alert legge questo campo e invia la notifica con priorità alta, che su iPhone arriva come notifica time-sensitive e supera le modalità Full immersion. La sezione "complete" non ha livello, quindi arriva come notifica push normale.{event_args[1]}è lo stato del lavoro dopo l'evento. Riflette l'oggettoprint_statsdi Klipper:filenameè il file G-code,messageè il testo dell'errore di Klipper quando una stampa fallisce.{event_name}è l'evento che si è verificato, così una sola sezione copre siaerrorsiacancellede il titolo indica comunque quale dei due è successo.
Passo 3. Riavvia Moonraker e fai un test
Riavvia Moonraker dal menu di alimentazione in Mainsail o Fluidd, oppure via SSH:
sudo systemctl restart moonraker
Prima di consumare filamento per un test, verifica il webhook con curl. Questo invia la stessa struttura JSON che usa Apprise:
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"}'
Se il telefono vibra, la parte di Pocket Alert funziona. Ora avvia una stampa piccola e annullala dopo il primo strato: dovresti ricevere ❌ Print cancelled in pochi secondi.
Cosa arriva sul telefono
Una stampa fallita di notte appare così sulla schermata di blocco:
Webhook Voron 2.4
❌ Print error
3DBenchy.gcode Move out of range: 235.000 0.000 0.200 [0.000]
Sai quale stampante, quale file e perché si è fermata prima ancora di sbloccare il telefono.
Personalizzalo
Tutto quello che segue è una piccola modifica allo stesso file.
- Registra in silenzio l'inizio delle stampe. Aggiungi una sezione con
events: startede?:level=silent. L'avvio viene registrato nella cronologia dei messaggi senza suono. - Fatti svegliare dagli errori. Sostituisci
?:level=highcon?:level=criticalnella sezione dei fallimenti. Su Android un avviso critico supera Non disturbare. La consegna critica è una funzione a pagamento; con il piano gratuito il messaggio arriva comunque con priorità alta. Dettagli in avvisi critici. - Più stampanti. Un webhook per ogni stampante, ciascuno con il nome della macchina. Il titolo della notifica ti dice quale si è fermata.
- Avvisi dalle tue macro. Moonraker ha anche un evento
gcode, quindi una macro Klipper può inviare qualsiasi testo tu voglia. Utile per un cambio filamento o per un sensore di esaurimento.
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")}
Richiama NOTIFY_FILAMENT_CHANGE dalla tua macro M600 oppure dal runout_gcode di un sensore di filamento.
Se non arriva nulla
- Apri il webhook nella dashboard. Cronologia webhook registra ogni chiamata con il payload originale. Se non c'è nessuna voce, Moonraker non ha mai raggiunto Pocket Alert. Una voce con errore ti indica il motivo.
- Leggi
moonraker.log. Moonraker scrive lì gli errori del notifier, insieme alla versione di Apprise installata. Nella maggior parte delle installazioni si trova in~/printer_data/logs/moonraker.log. - Righe vuote nella notifica. Le chiavi del modello devono corrispondere al payload di Apprise:
%title%e%message%, non%body%.
Perché non un plugin?
I bot Telegram e i servizi di accesso remoto per Klipper fanno di più: snapshot della camera, timelapse, controllo remoto. Però aggiungono un altro servizio sul Pi da installare e tenere aggiornato. Se ti basta "dimmi quando è finita, svegliami se fallisce", Moonraker fa già l'invio: a Pocket Alert resta solo da riceverlo.
E se la stampante vive accanto a un homelab, i suoi avvisi finiscono nella stessa app dei tuoi avvisi del server, dei backup e dei cron job, con un'unica cronologia e gli stessi livelli di priorità.
FAQ
Devo installare qualcosa sul Raspberry Pi?
No. Il notifier fa parte di Moonraker, e Apprise viene installato insieme come dipendenza. Devi solo modificare moonraker.conf e riavviare Moonraker.
Funziona con Mainsail e Fluidd?
Sì. Entrambe sono interfacce web per Moonraker e il notifier vive in Moonraker, quindi la configurazione è identica. Puoi modificare moonraker.conf da una qualsiasi delle due.
Posso ricevere notifiche da più stampanti?
Sì. Crea un webhook per ogni stampante e dagli il nome della macchina. Il nome del webhook diventa il titolo della notifica push.
Una stampa fallita mi sveglia di notte?
Con level=high la notifica arriva come time-sensitive su iPhone e supera Full immersion. Per superare Non disturbare su Android, usa level=critical con un piano a pagamento.
È gratuito?
Sì. I webhook funzionano con il piano gratuito e ogni evento consuma un messaggio dal tuo limite giornaliero: una stampa tipica ne invia uno o due.
Crea un webhook, incolla la configurazione e la tua prossima stampa ti dirà quando è finita.