Назад в блог

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

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_stats Klipper: 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 на платном тарифе.

Это бесплатно?

Да. Вебхуки работают на бесплатном тарифе, а каждое событие расходует одно сообщение из дневного лимита. Обычная печать отправляет одно-два.

Создайте вебхук, вставьте настройки, и следующая печать сообщит, когда она закончится.

Поделиться статьёй