Chitu Notify

Version: 1.0.0 | Author: ChitUI Developer | UI: Toolbar (bell icon)

Dependencies: requests, qrcode[pil]

Delivers real-time push notifications to any device through the ntfy.sh service. Monitors the full printer lifecycle and system events, dispatching customizable alerts the moment something happens. Other plugins register their own alarm definitions into Chitu Notify, so a single topic subscription covers the entire ChitUI installation.

Features

Features

-         Push notifications via the ntfy.sh open-source service

-         Configurable ntfy.sh server URL — use the public server or a self-hosted instance

-         Auto-generated unique random topic with one-click regeneration

-         QR code generation for the subscription topic — scan to subscribe from any mobile device

-         Per-alarm enable/disable toggle for fine-grained control over which events trigger notifications

-         Per-alarm priority level: min, low, default, high, urgent

-         Per-alarm custom message text and emoji tags

-         Built-in alarms: printer_connected, printer_disconnected, print_started, print_paused, print_stopped, print_completed, print_failed, system_boot

-         SDCP print state tracking: IDLE, HOMING, DROPPING, EXPOSURING, LIFTING, PAUSING, PAUSED, STOPPING, STOPPED, COMPLETE

-         Plugin alarm registry — other plugins dynamically register their own notification definitions at startup

-         Rolling notification log storing the last 50 sent notifications with timestamps

-         Log clear endpoint for resetting notification history

-         Test notification endpoint to verify setup without waiting for a real event

-         REST API: /status, /config, /printers, /regenerate_topic, /test, /log, /log/clear, /qrcode, /settings, /plugin_alarms

-         Graceful degradation when requests or qrcode libraries are unavailable

-         Configuration persisted in ~/.chitui/chitu_notify_config.json