Push-уведомления Klipper: оповещения о печати на телефон

Двенадцатичасовая печать не требует, чтобы вы стояли рядом. Ей нужно, чтобы вы узнали о ней в нужный момент: когда она закончится и, что важнее, когда остановится.
Klipper уже умеет сообщать о том и о другом. В Moonraker, API-сервере, на котором работают Mainsail и Fluidd, есть встроенный notifier: он срабатывает на события печати и отправляет их через Apprise. Укажите ему вебхук Pocket Alert, и каждая завершённая, сорвавшаяся, отменённая или приостановленная печать придёт на телефон push-уведомлением. Без плагина, без дополнительного сервиса на Raspberry Pi, один блок настроек.
Что понадобится
- Принтер с Klipper и Moonraker. Если Mainsail или Fluidd открываются в браузере, Moonraker у вас уже есть.
- Бесплатный аккаунт Pocket Alert и приложение на iPhone или Android.
- Около пяти минут.
Шаг 1. Создайте вебхук в Pocket Alert
Откройте Webhooks на панели и создайте новый вебхук:
- Name: название принтера, например
Voron 2.4. Оно становится заголовком push-уведомления (Webhook Voron 2.4), поэтому при нескольких принтерах сразу видно, какому нужно внимание. - Application и Device: куда отправлять уведомление.
- Message: вставьте этот шаблон:
%title%
%message%
Сохраните и скопируйте URL вебхука. Он выглядит так: https://p4a.me/wh/<your-webhook-id>.
Зачем нужен этот шаблон: Moonraker передаёт каждое уведомление в Apprise, а JSON-notifier Apprise отправляет небольшой payload такого вида:
{
"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"
}
Каждый %key% в шаблоне заменяется соответствующим полем из JSON. В push заголовок выводится первой строкой, а сообщение под ним. Подробнее о путях в шаблонах читайте в статье Create your first webhook URL.
Шаг 2. Добавьте notifier'ы в moonraker.conf
Откройте moonraker.conf: в Mainsail это раздел Machine, в Fluidd: Configuration. Добавьте в конец файла три секции. Замените YOUR_WEBHOOK_ID на идентификатор из 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
Что делает каждая часть:
jsons://это JSON-notifier Apprise поверх HTTPS. Он отправляет payload выше на ваш вебхук.eventsвыбирает состояния печати, которые запускают секцию. Moonraker знаетstarted,complete,error,cancelled,pausedиresumed.?:level=highговорит Apprise добавить"level": "high"в JSON. Pocket Alert читает это поле и отправляет push с высоким приоритетом: на iPhone такое уведомление приходит как срочное и проходит через режимы Фокусирование. У секции «complete» уровня нет, поэтому она приходит как обычный push.{event_args[1]}это состояние задания после события. Оно повторяет объектprint_statsKlipper:filenameэто G-code файл,messageэто текст ошибки Klipper, когда печать срывается.{event_name}это событие, которое сработало. Поэтому одна секция покрывает иerror, иcancelled, а заголовок всё равно говорит, что именно произошло.
Шаг 3. Перезапустите Moonraker и проверьте
Перезапустите Moonraker из меню питания в Mainsail или Fluidd либо по SSH:
sudo systemctl restart moonraker
Прежде чем тратить пластик на тестовую печать, проверьте вебхук через curl. Эта команда отправляет тот же JSON, что и 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"}'
Если телефон завибрировал, часть Pocket Alert работает. Теперь запустите небольшую печать и отмените её после первого слоя: через несколько секунд должно прийти ❌ Print cancelled.
Что приходит на телефон
Сорвавшаяся ночью печать выглядит на экране блокировки так:
Webhook Voron 2.4
❌ Print error
3DBenchy.gcode Move out of range: 235.000 0.000 0.200 [0.000]
Вы знаете, какой принтер, какой файл и почему он остановился, ещё до того, как разблокируете телефон.
Настройте под себя
Всё ниже делается небольшой правкой того же файла.
- Тихо фиксируйте старт печати. Добавьте секцию с
events: startedи?:level=silent. Старт сохранится в истории сообщений без звука. - Просыпайтесь от сбоев. Замените
?:level=highна?:level=criticalв секции ошибок. На Android критическое оповещение пробивается через режим «Не беспокоить». Критические уведомления доступны в платном тарифе; на бесплатном тарифе сообщение всё равно придёт с высоким приоритетом. Подробности в статье critical alerts. - Несколько принтеров. Один вебхук на каждый принтер, названный по имени машины. Заголовок push подскажет, какой принтер остановился.
- Уведомления из своих макросов. У Moonraker есть событие
gcode, поэтому макрос Klipper может отправить любой текст. Это удобно для смены филамента или датчика окончания пластика.
В moonraker.conf:
[notifier pocketalert_macro]
url: jsons://p4a.me/wh/YOUR_WEBHOOK_ID?:level=high
events: gcode
title: 🧵 Printer needs you
body: {event_message}
В printer.cfg:
[gcode_macro NOTIFY_FILAMENT_CHANGE]
gcode:
{action_call_remote_method("notify",
name="pocketalert_macro",
message="Filament change needed")}
Вызывайте NOTIFY_FILAMENT_CHANGE из макроса M600 или из runout_gcode датчика филамента.
Если ничего не приходит
- Откройте вебхук на панели. История вебхуков фиксирует каждый вызов вместе с исходным payload. Если записей нет, Moonraker не смог достучаться до Pocket Alert. Запись с ошибкой подскажет причину.
- Посмотрите
moonraker.log. Moonraker пишет туда ошибки notifier'а и версию установленного Apprise. На большинстве установок файл лежит в~/printer_data/logs/moonraker.log. - Пустые строки в push. Ключи шаблона должны совпадать с payload Apprise:
%title%и%message%, а не%body%.
Почему не плагин?
Telegram-боты и сервисы удалённого доступа для Klipper умеют больше: снимки с камеры, таймлапсы, удалённое управление. Но они добавляют на Raspberry Pi ещё один сервис, который нужно устанавливать и обновлять. Если вам нужно «сообщи, когда закончится, разбуди, если сорвётся», Moonraker уже сам отправляет уведомления, а Pocket Alert лишь принимает их.
А если принтер стоит рядом с домашней лабораторией, его оповещения попадают в то же приложение, что и уведомления о сервере, бэкапах и cron-задачах: с одной историей и теми же уровнями приоритета.
FAQ
Нужно ли что-то устанавливать на Raspberry Pi?
Нет. Notifier входит в состав Moonraker, а Apprise устанавливается вместе с ним как зависимость. Вам нужно только отредактировать moonraker.conf и перезапустить Moonraker.
Работает ли это с Mainsail и Fluidd?
Да. Оба интерфейса работают с Moonraker, а notifier находится в самом Moonraker, поэтому настройка одинаковая. Редактировать moonraker.conf можно из любого из них.
Можно ли получать уведомления с нескольких принтеров?
Да. Создайте по одному вебхуку на каждый принтер и назовите его по имени машины. Название вебхука становится заголовком push-уведомления.
Разбудит ли меня сорвавшаяся ночью печать?
С level=high push приходит на iPhone как срочное уведомление и проходит через Фокусирование. Чтобы пробиться через «Не беспокоить» на Android, используйте level=critical на платном тарифе.
Это бесплатно?
Да. Вебхуки работают на бесплатном тарифе, а каждое событие расходует одно сообщение из дневного лимита. Обычная печать отправляет одно-два.
Создайте вебхук, вставьте настройки, и следующая печать сообщит, когда она закончится.