Repository navigation
v2.3.0
Spooler 2.3.0 collects everything from the 2.3.0 beta series (beta.1 to beta.7) plus the Centauri Carbon 2 progress fix.
Docker: ghcr.io/tharje/spooler-v2:2.3.0 (also :latest, and :beta now follows this release).
Changes
- Upload files to the printer from the UI (CC1, CC2, Klipper/Moonraker, Prusa/PrusaLink) — CC2 uses the same chunked upload as ElegooSlicer
- Report bug button in the footer — pick the printer, describe the issue, and open a prefilled GitHub issue with redacted diagnostics (IPs, serials, names and access codes removed)
- CC2: poll the full status instead of machine status only
- Secrets at rest are now protected with locked-down file permissions
- Notifications: send to ntfy, Telegram, Discord or any webhook as well as browser push (set up and switched on or off under Settings → Notifications, each with a Send test button)
- New notification events: print started, paused, error (with the cause and code), filament runout, and printer offline / back online; completion, start, pause, error and runout notices can include a camera picture
- CC2: error codes now shown with a readable cause (about 33 codes from Elegoo's own firmware source: heaters, fans, sensors, Canvas filament feed, cutter and more), including a suggested fix where Elegoo names one; faults are read from the printer's exception list, and command replies like "printer busy" are no longer mistaken for faults
- CC2: the status badge now says what the printer is doing while it prepares (Heating nozzle/bed, Homing, Leveling, Loading/Unloading filament, Self-check) instead of just "Preparing"
- CC1: self-check, leveling, resonance test, PID calibration, filament unloading and file checks outside a print are now shown (with the same activity labels as CC2) instead of looking idle, and the newer status codes Elegoo uses are recognised
- CC1: if the printer rejects Start/Pause/Stop/Resume (busy, file not found, file check failed, wrong model), Spooler now tells you why instead of staying silent; a CC1 print that stops with an error points you to the printer's screen
- CC1: a clear message when the printer refuses the connection because all 5 of its connection slots are in use
- A camera picture is saved with each finished, cancelled or failed print and shown as a thumbnail in the print history (click for full size); it can be switched off under Settings → Features, and old pictures are removed together with their history entries
- Optional per printer (Settings → Printers → edit, Centauri Carbon only): the light turns on when a print starts and off when it ends, after the end-of-print picture has been taken
- API access (Settings → API access, off by default): other programs can use an API key to read the print history, pictures and statistics and change reference numbers; keys are shown once, stored hashed, and open only this API (see docs/external-api.md)
- New Stats & history page (Stats in the side menu, replaces History): an Overview tab with prints, success rate, print time and filament for 7 days, 30 days, 12 months, all time or a custom period (per printer if you like) with a chart per day/week/month, filament by material, results and why prints stopped, and a Prints tab where you can search and open any print to see its picture, result and cause, times, filament, material, spools, pauses, and give it a reference number; CSV export includes the reference (Settings → Features → Statistics)
- Filament use is now written to a ledger before it is sent to Spoolman and retried until Spoolman takes it (it is never counted twice): Spoolman being down, a restart in the middle of a print, a printer counter that resets, or a spool change no longer loses or doubles filament. Deductions that did not go through are listed under Spools with Try again / Discard, with a badge on the Spools button when something needs you
- A warning ("Login is off" in the footer and on the Features page) is shown for as long as login is switched off (AUTH_ENABLED=false); features that act on the printers cannot be used then
- Firmware versions are shown on every printer card (Centauri Carbon, Klipper, Prusa); a small yellow "untested firmware" notice appears for versions not in the tested list, and a firmware change is logged and can be notified (Settings → Notifications → Firmware changed)
- Fixed: "Last updated" and the dimming of stale data now use the server's clock, so a phone or PC with the wrong time no longer makes fresh data look old; renaming a printer or changing its address no longer counts as hearing from it
- Printer cards show the current layer (e.g. "Layer 25 / 120") next to the elapsed and remaining time
- CC2: emergency stop, power-loss recovery, filament loading/unloading, leveling, homing and self-checks outside a print are now shown instead of looking idle
- Web Push contact address is now configurable (VAPID_CONTACT) instead of hardcoded
- Filament catalogue import moved from the Spools panel to Settings → Integrations, now with a brand dropdown so you can import any brand from SpoolmanDB (Elegoo preselected)
- Webhook notifications now carry a schema_version, a unique id per event and a UTC timestamp, so a receiver can spot the same event twice (documented in docs/external-api.md)
- The frontend and the HTTP handler are split into smaller files (no change in behaviour)
- CC2: Spooler now re-registers with the printer when it stops answering (the light button and other commands could be silently ignored after the printer dropped the registration)
- CC2: the light and other commands work again after the printer has dropped Spooler's connection (it registers again instead of being ignored); CC2 file upload is now confirmed on a real printer
- CC2: a finished print is always recorded: history entry with picture, lights off and the "Print complete" notification, even when the printer reports a zero print time at the end or is busy for a moment before going idle; browser push subscriptions the push service reports as gone are removed
- Restarting Spooler (or the container) in the middle of a print no longer loses filament use: the figures are saved on shutdown, and a print that ended while Spooler was stopped is deducted with the printer's final figure
- CC1: the leveling phase is now labelled Leveling instead of Heating
- An offline printer shows -- for temperatures and no stale phase (for example a leftover "Leveling")
- Notifications: the hot-nozzle-while-idle warning is sent once per cool-down instead of repeatedly; every queued notification is logged
- Spools: the list of filament not deducted no longer shows entries Spoolman already has, and discarded entries can be dismissed with a button
- Linking a canvas slot to a spool now says so when Spooler is not connected, instead of showing success
- Camera proxy: the log now says why a camera picture isn't served
- README: screenshots added
- Centauri Carbon 1: finished prints and layer notices are announced again (its printing status wasn't counted as a print, so no notification was sent)
- Layer notice: sent once per print instead of again at later layers after a pause or a busy status, and not late after a restart; it can now include a camera picture (to check the print is still stuck to the bed)
- A pause notice on the printer card goes away as soon as the printer starts working again, also when it reheats or levels first
- Automatic light: the light is turned off when a print ended while Spooler was not running
- Notification settings: space between the layer number and the photo option
- New: Service logbook (Service in the side menu). Note what you have done to each printer and get a reminder, with a notification, after a set number of print hours
- New: Spaghetti detection (optional, off by default). Watches running prints through the camera with an Obico detector that you run yourself and sends a notification with a picture if a print looks like it is failing. Setup: docs/spaghetti-detection.md
- Centauri Carbon 2: firmware 02.01.01.07 is marked as tested
- Fixed: filament fed or heated by hand with no print running (loading filament, clearing a clog) no longer shows up in the history as a cancelled print
- Settings: the Spoolman section under Integrations now starts closed like the others
- Fixed: the camera could stop working until the printer was power cycled (Centauri Carbon 2). Spooler now keeps one connection to each printer's camera, shared by every browser tab, instead of one per tab and refresh
- Fixed: Discord notifications failed with HTTP 403 because Discord's Cloudflare blocks Python's default user agent. Spooler now identifies itself as Spooler (thanks joshm-cmd)
- Camera (Centauri Carbon 2): Spooler now keeps even fewer connections to the printer's camera. Pictures for Obico, notifications and the end-of-print image are taken from the one shared stream instead of opening and cutting off a new one each time, and the stream is closed when nobody needs it
- Camera: if the printer refuses camera connections, Spooler tries once a minute instead of every few seconds, and the camera box now suggests power cycling the printer
- Centauri Carbon 2: print progress now uses the percentage the printer itself reports while a print is running, so it matches the printer's own screen (before, it was estimated from time and could differ by 10 points); the old estimate is only used if the printer doesn't send it (thanks joshm-cmd)
- Centauri Carbon 2: the camera stopping until the printer is power cycled is a fault inside the printer's own camera service (each connection to the camera keeps 8 MB of memory reserved, and after roughly 370 connections the service crashes), not in Spooler. Spooler keeps its connections to a minimum; a real fix has to come in the printer firmware, and a patch is being worked on
Thanks to everyone who tested the betas and reported issues, especially joshm-cmd.