Skip to content
bloodfPublic

About

Spoolman inventory for OrcaSlicer: auto-synced filament profiles and live printer slots (fork of Spoolio)

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Spooler: Your Spoolman stock inside OrcaSlicer, with what is left on each spool.

🧵 Spooler

Your Spoolman stock inside OrcaSlicer, with what is left on each spool.
An OrcaSlicer plugin · by bloodf

Install from Orca Cloud Latest release OrcaSlicer 2.5+ License

Install · Features · How to use · FAQ · Português

✨ What it does

Spooler reads your spools from Spoolman and lists them in a tab inside OrcaSlicer, each with its material, colour, location and grams left. Every filament with a spool in stock becomes an OrcaSlicer filament preset for each of your printers, already in its colour. The Printer tab shows which spool sits in each toolhead, lane or AMS slot, and after a slice Spooler compares what the plate needs with what is left.

The Spools tab: twelve spools with material, state and grams left, and the detail of a PETG spool with 640 g left that lasts about 7.1 weeks

📦 Install

Open Spooler on Orca Cloud and subscribe, then in OrcaSlicer open File > Plugins, click Refresh and tick Activate. Updates arrive the same way.

From a file:

  1. Download spooler_any.py from the latest release. It is the same file on Windows, macOS and Linux.
  2. Put it in its own folder called spooler inside OrcaSlicer's plugin directory, one Spooler file per folder: %APPDATA%\OrcaSlicer\orca_plugins\ on Windows, ~/Library/Application Support/OrcaSlicer/orca_plugins/ on macOS, ~/.config/OrcaSlicer/orca_plugins/ on Linux.
  3. Restart OrcaSlicer and tick Activate for Spooler. A Spooler tab appears in the top bar.
Requirement Detail
OrcaSlicer 2.5.0 or later, for the plugin preset APIs
A spool source A Spoolman server you can reach, or a Bambu Cloud account (read-only, experimental)
Printers Optional. Klipper/Moonraker, Snapmaker U1, Anycubic in LAN mode, Bambu Lab in LAN mode, PrusaLink and OctoPrint are read
System Windows, macOS or Linux

docs/install.md shows each step with a picture.

Spooler is a fork of Spoolio by Dan J Moore that adds a setup guide. It is an independent project, not affiliated with or endorsed by Spoolman, OrcaSlicer, Snapmaker, Sovol, Anycubic or Bambu Lab.

🧰 Features

The spool list: material, state chips and grams left for each spool

Every spool in one list
Material, colour, location and grams left, read from Spoolman and updated within a second or two.

The setup guide's step about presets: one per filament and printer, under User presets

Stock becomes filament presets
One preset per filament and printer under User presets, in the filament's colour and with its temperatures.

The Printer tab: the four toolheads of a Snapmaker U1, each with its spool and grams left

What each slot holds
Toolheads, lanes and AMS slots matched to your spools, with the preset each one gets.

The This plate panel: two slots with enough filament and one that is 32 g short

A check after every slice
What the plate needs against what is left, with a notice that stays when a spool runs short.

Feature What you get
Presets per printer Each preset is a standalone copy of the closest preset OrcaSlicer has for that printer (refreshed on Sync Presets) and adds colour, vendor, nozzle and bed temperatures, density, diameter and cost from Spoolman. Example: 3D Procer PLA Pérola @Snapmaker U1.
Calibrated settings A JSON orca_settings field on the Spoolman filament, per printer or * for all, plus Flow ratio, Pressure advance and Max volumetric speed fields on Spoolman's filament form.
Edits go back Change a Spooler preset in OrcaSlicer and it is sent to Spoolman after a few seconds, or at once with Send to Spoolman in the spool's detail.
Search and filters Search matches name, location, lot number and comment, and #12 finds spool 12. Material and colour filters, grouping, sorting, and Closest colour, which lists the 12 nearest spools.
Spool actions Set weight from scale, Use filament, Set grams left, Add a note, Move, Mark dried today, Add a spool of this filament (1 to 20), Archive and Open in Spoolman.
Spool detail What is left, how long it lasts, the prints that used the spool, grams and cost booked, and weekly use over the last 4 weeks.
Low stock A notification when a spool crosses your threshold (100 g by default), and a Use first chip on the oldest opened spool of a filament.
Drying reminder Dried 12 d ago on the spool, amber past the days set per material: PETG 30, TPU 14, PA 7, PVA 7, PC 14.
Slots on the plate Plugins > Run > Spooler: Load Printer Filaments puts each slot's preset on the plate. Keep Slots Synced keeps doing it when a spool changes.
Usage booking With Spoolman and a Bambu Live Link, the grams a print used are booked to the spool in each slot: Ask me before booking, Book automatically or Don't track.
Stats Usage, cost and print history, filament lost to supports, purging and failed prints, the value on the shelf, and Export to CSV.
Works with U1 Control Both plugins pick the same preset for a toolhead, and U1 Control books the filament used on the U1.

The user guide has every setting, the supported orca_settings keys and the limits.

🛠️ How to use

  1. Open the Spooler tab. On first run the setup guide opens over Settings.
  2. Under Choose your source, enter your Spoolman address, for example http://raspberrypi.local:7912, and click Test. Next becomes available once it connects.
  3. Allow the permission prompts. OrcaSlicer asks the first time Spooler reaches Spoolman or a printer and the first time it writes presets. Granting full access once avoids the repeats.
  4. Click Save & finish. The Spools tab lists your stock.
  5. In the sidebar's filament dropdown, pick a filament under User presets. The slot takes the filament's colour.
  6. Open the Printer tab. Printers whose printer preset has a host address are already there. For a Bambu printer, click + Add printer and Live Link.
  7. Run Plugins > Run > Spooler: Load Printer Filaments to put what the printer holds on the plate.
  8. To be warned before a print, switch on Spooler Filament Check in the process settings under Others > Slicing Pipeline Plugin. The result shows as a notification and in This plate on the Printer tab.

Step 2 of the setup guide: the Spoolman address field, the Test button and the answer Connected: Spoolman v0.27.1

How each printer is read:

Printer What Spooler shows Set up
Snapmaker U1 Four toolheads, matched by spool id, else RFID tag, else vendor, material and colour Host address in the printer preset
Klipper with AFC, Happy Hare or another tool that writes lane_data Every lane, matched by spool id, else vendor, material and colour Host address in the printer preset
Single-extruder Klipper, for example Sovol SV06 Moonraker's active spool, with Change spool and Clear Host address in the printer preset
Anycubic Kobra X and other Anycubic printers ACE slots and the external spool, matched by material and colour LAN mode on, IP address in the printer preset's host field
Bambu Lab AMS slots and the external spool as the printer reports them Live Link with IP address and access code, LAN mode on
PrusaLink, OctoPrint Print progress; toolheads assigned by hand Live Link with the printer's password or an application key

🔒 Privacy and safety

Spooler has no telemetry and no account. It talks to the servers you point it at, and OrcaSlicer asks before it reaches a new address.

Where What Spooler reads What Spooler writes
Your Spoolman server Spools, filaments, locations and the server version The extra fields it needs (orca_settings, dried and the three calibration fields; it never deletes one), preset edits you send, spool actions you take, and booked grams
Your printers, on the local network Status reports over Moonraker, Anycubic LAN mode and Bambu Live Link Only Moonraker's active spool, when you use Change spool or Clear
Bambu Cloud, if you choose it Your filament library Nothing. The sign-in token is kept on your computer, never the password
GitHub The latest release number, when checking for an update Nothing
Your computer OrcaSlicer's presets and the sliced plate's filament use Its presets in OrcaSlicer's user folder, and settings, log, history and CSV exports in <OrcaSlicer data folder>/spooler/

Printer access codes stay in that folder and go nowhere but the printer. The links to Bambu and Anycubic printers don't verify the printer's certificate, since the printers use self-signed ones, so they trust your local network. The reorder cart opens a web search for the filament in your browser, only when you click it. Spooler downloads no code and starts no programs. SECURITY.md has the full list and how to report a problem.

❓ FAQ

Does it work without Spoolman?

Yes, with Bambu Cloud as the source. It is read-only and uses Bambu's unofficial service, so there are no spool actions and no usage booking, and the sign-in expires from time to time.

Why did the slot colours not change after Load Printer Filaments?

OrcaSlicer gives plugins no way to change a slot's colour, so the action sets the right presets and leaves the colours as they were. Pick the filament in the slot's dropdown, or use OrcaSlicer's own Sync filaments, to set the colour.

I pressed Save on a Spooler preset. Why did it stop following Spoolman?

OrcaSlicer can't save over a preset a plugin owns, so Save makes a separate copy. Spooler shows that copy's changed calibration settings, old and new, and asks before saving them to Spoolman (Settings can make it save automatically or never); once saved, the Spooler preset has them after its next rebuild. To change a preset and keep it following Spoolman, edit it and use Send to Spoolman in the spool's detail. To keep a tuned preset of your own instead, link it to the spool (see below).

Which preset does Send to Spoolman send?

The one you pick under OrcaSlicer preset in the spool's detail, never whichever preset was opened last. If that preset is open in OrcaSlicer's filament settings with unsaved edits, the edits are sent. If it has none, there is nothing new for a Spooler preset (its saved settings come from Spoolman) and Spooler says so; for your own linked preset, its saved settings that differ from Spooler's are sent. Colour, vendor, material and name are changed in Spoolman.

Can a spool use my own tuned filament preset instead of Spooler's?

Yes. In Edit Spool, pick it under OrcaSlicer preset, for the spool or for its filament (every spool of it). Spooler keeps the name in a Spoolman text extra field, orca_filament_preset, which you can also fill in Spoolman: the preset's exact name, on the spool or on the filament (the spool's wins). Spooler then makes no preset for that spool and picks yours wherever it would pick its own, on the printers your preset is compatible with; on the others the spool keeps Spooler's preset. For a printer that isn't selected, Spooler goes by the preset's compatible printers list, so a preset limited only by a condition, or listing only your own copy of a printer preset, is used there only while that printer is selected. U1 Control and Kobra Control read the same field.

Why does the list not update live behind my reverse proxy?

Live updates use Spoolman's WebSocket at /api/v1/spool. The proxy must pass the Upgrade and Connection headers; in nginx, proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade";. Without it the list still refreshes every 60 seconds.

Which prints does Spooler book to Spoolman?

Bambu prints over Live Link. Klipper, PrusaLink and OctoPrint prints are always asked first, and Klipper only when Moonraker's own Spoolman integration is off, so nothing counts twice. The Snapmaker U1 is booked by U1 Control. Anycubic prints are not booked yet; docs/kobra-booking.md says what is missing.

Why are Stats and the spool history empty after installing?

They are built from what Spooler booked, so they start empty and fill as prints are booked.

Why do I see a Spooler tab and a U1 Control tab?

Each plugin has its own tab. U1 Control runs the Snapmaker U1 and links spools to its toolheads; Spooler shows your whole stock and what it reads from every printer.

🌍 Languages

English, Brazilian Portuguese, Spanish, German, Simplified Chinese and Polish. The page follows OrcaSlicer's language, and Settings > Language changes it.

🧩 More plugins by bloodf

Plugin What it does
Organizer icon 🧩 Organizer Arrange parts by their real outline and fill a plate with more copies. Install
Embedder icon 🧲 Embedder Magnet and NFC pockets, with the pause at the right layer. Install
Print Calculator icon 💰 Print Calculator Price every plate: filament, energy, labour, fees and margin. Install
Spooler icon 🧵 Spooler · you are here Your Spoolman stock inside OrcaSlicer, with what is left on each spool.
Kobra Control icon 🟣 Kobra Control Run the Anycubic Kobra X from OrcaSlicer over your LAN. Install
U1 Control icon 🔵 U1 Control Run the Snapmaker U1 from OrcaSlicer: toolheads, camera, files. Install

Each plugin works on its own; installed together they share data where it helps.

🤝 Contributing

Bug reports, printer data and pull requests are welcome: report a bug or request a feature. CONTRIBUTING.md covers the setup, the tests and the build, docs/ has a tour of the code and the release notes for maintainers, and NOTICE.md lists the credits. Everyone taking part follows the code of conduct.

📄 License

GPL-3.0-only. See LICENSE.

by bloodf

About

Spoolman inventory for OrcaSlicer: auto-synced filament profiles and live printer slots (fork of Spoolio)

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages