# Chitu Notify

Version: 1.1.5 | Author: ChitUI Developer | UI: Toolbar (bell icon)
Dependencies: requests, qrcode[pil]

## Updates

- Ability to have custom Topic names
- Notification titles now include the printer name
- Fixed: some SDCP messages were silently ignored, causing missed notifications
- Fixed: titles with special characters could silently fail to send

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

- 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

**Note:** Avoid generic or predictable topic names like `chitui_saturn4ultra`. Chitu Notify uses ntfy.sh, a free public server, and topics are not password-protected — anyone who subscribes to the same topic name will receive your notifications (and you could receive theirs). Use a unique, hard-to-guess name, or the printer serial / random suffix options below.