print-blockage-stopper abadrdh/print-blockage-stopper https://hub.docker.com/r/abadrdh/print-blockage-stopper latest Latest stable release bridge false --cap-drop=ALL --cap-add=DAC_OVERRIDE --cap-add=CHOWN --cap-add=FOWNER --cap-add=SETUID --cap-add=SETGID --security-opt=no-new-privileges https://forums.unraid.net/topic/197898-support-print-blockage-stopper-automated-print-head-maintenance/ https://github.com/ahmedbadr3/print-blockage-stopper Automated maintenance prints for any network printer (especially pigment printers like Canon imagePROGRAF, Epson SureColor, HP DesignJet, etc.). Sends a small test image on a configurable schedule (default: every 3 days) to keep all ink channels flowing and prevent costly pigment clogs and cleaning cycles. Features: multi-printer support, network printer discovery, per-printer schedules, smart skip (won't print if the printer was recently used), preset test images for 4/6/8/11/12-colour printers, custom image upload, notifications (webhook, email, Home Assistant), and a modern React dashboard with dark mode. Productivity: Tools: http://[IP]:[PORT:8631] https://raw.githubusercontent.com/ahmedbadr3/unraid-templates/main/print-blockage-stopper.xml https://raw.githubusercontent.com/ahmedbadr3/print-blockage-stopper/main/icon.png Keeps any network printer's print head healthy by automatically sending a small test print on a schedule. Prevents pigment ink clogs without wasting ink on full cleaning cycles. Supports multiple printers, auto-discovery, custom test images, and smart scheduling. Works with Canon imagePROGRAF, Epson SureColor, HP DesignJet, and other IPP Everywhere compatible printers. Buy me a coffee Any network printer with IPP Everywhere support (usually any modern networked printer). Especially useful for pigment printers. false ### 2.0.0 - Complete dashboard redesign with React, TypeScript, and Tailwind CSS - New multi-page layout with sidebar navigation (Dashboard, History, Settings) - Dark mode support with system-aware theme toggle - Redesigned printer cards with inline ink levels and quick actions - Modal-based Add/Edit printer dialogs with form validation - Dedicated History page with filterable records and chart visualizations - Centralized Settings page for global preferences and notifications - TanStack Query for efficient data fetching with background refresh - Fully responsive design with collapsible sidebar ### 1.6.0 - Dashboard visual refresh — modern look with animations and transitions - Animated pulsing status dots for connected printers - Card hover effects and status-colored borders (green/red) - SVG icons throughout (trash, download, printer, search) - Toast notification system for save/test/error feedback - Gradient buttons with press effect - Chart bar tooltips on hover - Ink bar gradient fills - Input focus glow rings - Header with app icon ### 1.5.1 - Print completion monitoring — polls CUPS job status for up to 3 minutes - Detects stopped/held jobs (paper tray, jam, ink issues) - Distinct notification events: completed, stopped, timeout, failed - Input validation fixes (port, skip hours) - Fixed cron day-of-week parsing bug - PRINTER_ID path traversal prevention ### 1.5.0 - Email notifications (SMTP) — configurable from dashboard - Home Assistant integration — persistent notifications via HA REST API - Tabbed notifications UI (Webhook | Email | Home Assistant) - Test button for each notification channel - Unified notification dispatcher (notify.py) - Added GitHub README ### 1.4.1 - Next scheduled print countdown on each printer card - Custom test image delete button - Favicon for browser tab - New app icon - Security hardening (CSRF protection, XSS fixes, SSRF prevention, Content-Security-Policy) - Fixed chart alignment in print history - Fixed thumbnail not updating when changing test image - Replaced deprecated cgi module, use threaded HTTP server - CUPS config now persists across container restarts - Portable grep for broader Linux compatibility ### 1.4.0 - Inline printer rename (double-click name to edit) - Test Connection button with auto-detect printer model - Real-time connection status indicators (green/red dots) - Ink level bars (via IPP marker attributes) - Print retry logic (auto-retry once after 30s on failure) - Webhook notifications for print success/failure (Slack, Discord, ntfy) - CSV export for print history - Test image thumbnails on printer cards - Mobile-responsive layout improvements ### 1.3.0 - Multi-printer support (add/remove from dashboard) - Network printer auto-discovery (mDNS/IPP) - Per-printer status, schedule, and skip-hours - Preset test images for 4/6/8/11/12-colour printers - Custom test image upload (max 5 MB) - Smart skip: won't print if printer was recently used - Dashboard schedule pause/resume toggle - 30-day print history chart ### 1.0.0 - Initial release 8631 631 0 10 */3 * * A4 72 ipp 9100 /mnt/user/appdata/print-blockage-stopper /usr/local/emhttp/webGui/scripts/notify