Repository navigation
Releases
v2.3.6
- Spool picker: each spool shows its number (#id) and, when it isn't on a printer, where it is stored, so spools of the same colour are easy to tell apart. A spool whose location is the printer's name is now marked as the printer's spool (#50)
- Centauri Carbon 1: firmware V1.4.49 (OpenCentauri) is on the tested list
v2.3.5
- Users and roles: Spooler can now have several logins, each with a role (Admin, Operator, Viewer or one you make) that decides what they may do and which printers they see; someone who can't see a printer can't print to it or control it either. The old single login becomes an admin, so nobody is logged out. Adding, renaming and removing printers is its own permission. Settings → Users and roles.
- Notifications per user: everyone picks their own events, browser push only goes to their own devices and only about printers they can see, and users who are allowed can add their own ntfy, Telegram, Discord or webhook under My channels.
- New: Advanced control (off by default, Settings → Features) for the Centauri Carbon 2: nozzle and bed temperature with presets, fans, moving and homing the axes, auto leveling, PID calibration of the nozzle and the resonance test (input shaper). Only for users with the Advanced control permission; every command is logged with who sent it. Tested on a real CC2.
- Advanced control for the Centauri Carbon 1: temperatures, fans, moving and homing, with the same commands as the printer's own web page. Temperatures are tested on a real CC1; fans and moving are not yet, so the panel says so. The CC1 has no network command for leveling, PID or the resonance test.
- Idle guard: heating left on while a printer isn't printing is switched off after 30 minutes (adjustable in the Advanced control panel, 0 = off). Printing, preheating, leveling and calibration don't count.
- New menu: Stats, Spools, Service, Queue and Settings open as pages next to the side menu instead of panels sliding over the printers, with a Printers item to get back. The back button works and a reload stays on the same page. On a computer, Stats uses the whole width and fits without scrolling.
- New Me page (tap your name at the bottom of the menu): your role and permissions, your prints with records and milestones, your push devices (with Remove), your queue jobs and commands, and your account. Prints started from Spooler now record who started them, so these statistics count from this version on.
- Centauri Carbon 2: bed leveling chosen when starting a sliced file now actually runs (the printer ignored it before).
- Centauri Carbon 2: error 704 (leveling failed) explains the likely cause and what to try, and all 75 error codes the printer's screen knows are listed (was 36).
- Centauri Carbon 2: the card no longer stays on Leveling or Homing after the printer has gone back to idle.
- Every printer action over the live connection now checks the user's permission.
v2.3.4
- Spools: reels of the same brand, material and colour are now stacked as one row (total grams, number of reels, which printers they sit in); tap a stack to see each reel. Search, a material filter and a Low/empty filter appear when you have more than one spool, and stacks that are empty or low come first.
- Centauri Carbon 2: filament used right after a print starts was sometimes dropped ("No spool is linked to the slot that was feeding") because the printer reports no active Canvas slot for a moment. It now goes to the first spool that takes over.
- Centauri Carbon 2: a print that was stopped early could be booked as the estimate for the whole file (131.6 g for a print stopped after two minutes). A stopped print now only counts what was seen while it ran. Worked out from the code and logs, not yet reproduced on a printer.
- New screenshots and a short demo GIF in the README.
v2.3.3
- Centauri Carbon 2: the print dialog now lets you choose which Canvas slot each colour in the file uses, with coloured slot buttons pre-filled with the closest match (same material first), a warning if the material does not fit, and an Auto option. The choice is sent to the printer like a slicer does. Offered for every file on the printer; "upload and start" and the print queue still start without it. Not yet verified with a real multi-colour print.
- Centauri Carbon 2: the model picture now shows in the print dialog (the thumbnail request sent the file name under the wrong field).
- Centauri Carbon 2: deleting a file from the printer's file list works again. It was ignored and answered with error 1003. Worked out and confirmed on firmware 02.01.01.07 only, so it may not work on other firmware versions; if the printer refuses, Spooler now shows a message with the error code.
v2.3.2
- Print history now records the layer count reached, for every printer type, not just Centauri Carbon (#26)
- Klipper/Moonraker: layer count is now read from the printer, once the slicer's start g-code sets it (#26)
- Stats: a "Layers printed" total, overall and per printer (#26)
- index.html is no longer cached, so an update always shows up without a hard refresh or clearing the app's cache
- Integrations: a settings group no longer closes itself right after pressing "Test connection" (#27)
- The end-of-print picture now waits a few seconds after the print is reported done, so it doesn't show the toolhead still parking over the model
- The end-of-print picture turns the light on first if it was off, then back off afterwards, so the picture isn't dark even without automatic light switching on
- Picture collection: a picture of the plate is saved the moment each print starts, before anything is on it, to build towards a future build-plate-readiness check
- New: a print queue (off by default) — queue up g-code files with requirements (printer type/material/quantity/priority), or pick a file already on a printer with a new "Queue next" button in its file browser; a free, matching printer is offered the job, but nothing is ever uploaded or started until you confirm the plate is clear, from the new Queue panel
v2.3.1
Spooler 2.3.1 is a small feature release on top of 2.3.0.
Docker: ghcr.io/tharje/spooler-v2:2.3.1 (also :latest).
Changes
- Picture collection (off until you choose a folder): saves a camera picture at an adjustable interval during prints, with a note on how each print ended and Looks OK / Failing now buttons that save a labelled picture
- New version notice (off by default): a daily check against GitHub shows a small notice in the footer when a newer release exists, with a Skip button; nothing about you or your printers is sent
- Notifications: Telegram can now send to one topic in a group (optional topic number)
- Settings: notification events and the Features switches are grouped into drop-down menus that keep their open state; the Notification channels menu and the other Settings pages share one look
- Settings: Integrations is now called Services and data
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.
v2.3.0-beta.7
Spooler v2.3.0-beta.7 (pre-release)
Still a beta. A small camera release on top of 2.3.0-beta.6; the beta.1 notes (what's new since 2.2.6, how to test, going back to 2.2.6) still apply. The :latest image is not changed by this release.
Image: ghcr.io/tharje/spooler-v2:beta (or the exact :2.3.0-beta.7)
Changed
- 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 connection each time, and the stream is closed when nobody needs it (#21).
- If the printer refuses camera connections, Spooler retries once a minute instead of every few seconds, and the camera box suggests power cycling the printer.
Please test especially
CC2 owners: leave the dashboard open with the camera visible in a few tabs for a day or two and check it keeps working. If the camera still dies, note whether Obico or other camera viewers were running, and tell us in #21.
v2.3.0-beta.6
Spooler v2.3.0-beta.6 (pre-release)
Still a beta. A small fix release on top of 2.3.0-beta.5; the beta.1 notes (what's new since 2.2.6, how to test, going back to 2.2.6) still apply. The :latest image is not changed by this release.
Image: ghcr.io/tharje/spooler-v2:beta (or the exact :2.3.0-beta.6)
Fixed
- Centauri Carbon 2: the camera could stop working until the printer was power cycled. Spooler now keeps one connection to each printer's camera, shared by every browser tab, instead of one per tab and refresh (#21).
- Discord notifications failed with HTTP 403 because Discord's Cloudflare blocks Python's default user agent. Spooler now identifies itself as Spooler (#20). Thanks to joshm-cmd for both reports.
Please test especially
Leave the dashboard open with the camera visible in a few tabs for several hours (CC2 especially) and check it keeps working. Send a test message to a Discord webhook. Found something? Use Report bug in the footer and mention your printer model and firmware version.
v2.3.0-beta.5 (pre-release)
Spooler v2.3.0-beta.5 (pre-release)
Still a beta. A small fix release on top of 2.3.0-beta.4; the beta.1 notes (what's new since 2.2.6, how to test, going back to 2.2.6) still apply. The :latest image is not changed by this release.
Image: ghcr.io/tharje/spooler-v2:beta (or the exact :2.3.0-beta.5)
Fixed
- Heating the nozzle and feeding filament by hand (loading filament, clearing a clog) no longer ends up in the print history as a cancelled print.
- Settings: the Spoolman section under Integrations starts closed like the others.
Please test especially
Load or unload filament by hand and check that nothing new appears in the history. Found something? Use Report bug in the footer and mention your printer model and firmware version.