Notificaciones push para Klipper: alertas de impresión en tu teléfono

Una impresión de doce horas no necesita que estés junto a la impresora. Necesita que sepas el momento exacto en que termina y, más importante aún, el momento en que se detiene.
Klipper ya puede avisarte de las dos cosas. Moonraker, el servidor de API detrás de Mainsail y Fluidd, tiene un notificador integrado que se activa con los eventos de impresión y los envía a través de Apprise. Apúntalo a un webhook de Pocket Alert y cada impresión terminada, fallida, cancelada o pausada llegará a tu teléfono como notificación push. Sin plugin, sin servicio extra en la Raspberry Pi y con un solo bloque de configuración.
Lo que necesitas
- Una impresora con Klipper y Moonraker. Si abres Mainsail o Fluidd en el navegador, ya tienes Moonraker.
- Una cuenta Pocket Alert gratuita y la aplicación en tu iPhone o Android.
- Unos cinco minutos.
Paso 1. Crea un webhook en Pocket Alert
Abre Webhooks en el panel y crea uno nuevo:
- Name – la impresora, por ejemplo
Voron 2.4. El nombre se convierte en el título de la push (Webhook Voron 2.4), así que si tienes más de una impresora verás de un vistazo cuál te necesita. - Application y Device – a dónde va la notificación.
- Message – pega esta plantilla:
%title%
%message%
Guarda y copia la URL del webhook. Tiene este aspecto: https://p4a.me/wh/<your-webhook-id>.
Por qué esta plantilla: Moonraker entrega cada notificación a Apprise, y el notificador JSON de Apprise envía una carga útil pequeña como esta:
{
"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"
}
Cada %key% de la plantilla se sustituye por ese campo del JSON. La push muestra el título en la primera línea y el mensaje debajo. Más información sobre las rutas de plantilla en Crea tu primera URL de webhook.
Paso 2. Añade los notificadores a moonraker.conf
Abre moonraker.conf (en Mainsail, en Machine; en Fluidd, en Configuration) y añade estas tres secciones al final. Sustituye YOUR_WEBHOOK_ID por el identificador de tu URL de 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
Qué hace cada parte:
jsons://es el notificador JSON de Apprise sobre HTTPS. Envía la carga útil de arriba a tu webhook.eventselige los estados de impresión que activan una sección. Moonraker reconocestarted,complete,error,cancelled,pausedyresumed.?:level=highle indica a Apprise que añada"level": "high"al JSON. Pocket Alert lee ese campo y envía la push con prioridad alta, que en iPhone llega como notificación sensible al tiempo y atraviesa los modos Concentración. La sección "complete" no tiene nivel, así que llega como push normal.{event_args[1]}es el estado del trabajo tras el evento. Refleja el objetoprint_statsde Klipper:filenamees el archivo G-code ymessagees el texto de error de Klipper cuando una impresión falla.{event_name}es el evento que se ha disparado, así que una sola sección cubreerrorycancelledy el título sigue indicando cuál de los dos ocurrió.
Paso 3. Reinicia Moonraker y haz una prueba
Reinicia Moonraker desde el menú de energía en Mainsail o Fluidd, o por SSH:
sudo systemctl restart moonraker
Antes de gastar filamento en una prueba, comprueba el webhook con curl. Esto envía la misma forma de JSON que 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"}'
Si el teléfono vibra, la parte de Pocket Alert funciona. Ahora inicia una impresión pequeña y cancélala después de la primera capa: deberías recibir ❌ Print cancelled en segundos.
Lo que llega a tu teléfono
Una impresión fallida de noche se ve así en la pantalla de bloqueo:
Webhook Voron 2.4
❌ Print error
3DBenchy.gcode Move out of range: 235.000 0.000 0.200 [0.000]
Sabes qué impresora, qué archivo y por qué se detuvo antes de desbloquear el teléfono.
Adáptalo a tu caso
Todo lo que sigue es una pequeña edición del mismo archivo.
- Registra en silencio el inicio de las impresiones. Añade una sección con
events: startedy?:level=silent. El inicio queda registrado en el historial de mensajes sin sonido. - Que los fallos te despierten. Cambia
?:level=highpor?:level=criticalen la sección de fallos. En Android, una alerta crítica atraviesa No molestar. La entrega crítica es una función de pago; en el plan gratuito el mensaje sigue llegando con prioridad alta. Detalles en alertas críticas. - Varias impresoras. Un webhook por impresora, cada uno con el nombre de la máquina. El título de la push te indica cuál se ha detenido.
- Alertas desde tus propias macros. Moonraker también tiene un evento
gcode, así que una macro de Klipper puede enviar cualquier texto que quieras. Es útil para un cambio de filamento o un sensor de fin de filamento.
En moonraker.conf:
[notifier pocketalert_macro]
url: jsons://p4a.me/wh/YOUR_WEBHOOK_ID?:level=high
events: gcode
title: 🧵 Printer needs you
body: {event_message}
En printer.cfg:
[gcode_macro NOTIFY_FILAMENT_CHANGE]
gcode:
{action_call_remote_method("notify",
name="pocketalert_macro",
message="Filament change needed")}
Llama a NOTIFY_FILAMENT_CHANGE desde tu macro M600 o desde el runout_gcode de un sensor de filamento.
Si no llega nada
- Abre el webhook en el panel. Historial de webhooks registra cada llamada con su carga útil sin procesar. Si no hay entrada, Moonraker nunca llegó a Pocket Alert. Una entrada con error te indica el motivo.
- Lee
moonraker.log. Moonraker escribe ahí los errores del notificador, junto con la versión de Apprise instalada. En la mayoría de instalaciones está en~/printer_data/logs/moonraker.log. - Líneas vacías en la push. Las claves de la plantilla deben coincidir con la carga útil de Apprise:
%title%y%message%, no%body%.
¿Por qué no un plugin?
Los bots de Telegram y los servicios de acceso remoto para Klipper hacen más: capturas de cámara, timelapses, control remoto. Pero también añaden otro servicio en la Raspberry Pi que instalar y mantener actualizado. Si lo que quieres es "avísame cuando termine y despiértame si falla", Moonraker ya se encarga del envío; Pocket Alert solo tiene que recibirlo.
Y si la impresora está junto a un homelab, sus alertas acaban en la misma aplicación que las de tu servidor, las copias de seguridad y las tareas cron, con un solo historial y los mismos niveles de prioridad.
Preguntas frecuentes
¿Tengo que instalar algo en la Raspberry Pi?
No. El notificador forma parte de Moonraker, y Apprise se instala con él como dependencia. Solo editas moonraker.conf y reinicias Moonraker.
¿Funciona con Mainsail y Fluidd?
Sí. Ambos son interfaces web de Moonraker, y el notificador vive en Moonraker, así que la configuración es idéntica. Puedes editar moonraker.conf desde cualquiera de las dos.
¿Puedo recibir notificaciones de varias impresoras?
Sí. Crea un webhook por impresora y ponle el nombre de la máquina. El nombre del webhook se convierte en el título de la push.
¿Una impresión fallida me despertará de noche?
Con level=high, la push llega como sensible al tiempo en iPhone y atraviesa Concentración. Para atravesar No molestar en Android, usa level=critical con un plan de pago.
¿Es gratis?
Sí. Los webhooks funcionan en el plan gratuito, y cada evento consume un mensaje de tu límite diario; una impresión típica envía uno o dos.
Crea un webhook, pega la configuración y tu próxima impresión te avisará cuando termine.