docs

Using SlicerX

Spoolman

Link filament slots to the spools in your Spoolman inventory, see what is left, and subtract what a print used.

Spoolman is a free, self-hosted filament inventory: it keeps track of every spool you own and how much is left on it. SlicerX reads that inventory, so each filament slot can point at a real spool, and after a print it can subtract what the print used.

Set up Spoolman

  1. Run Spoolman on your network.

    Install it with Docker or on its own on a computer on your local network, and add your spools in its web page. It listens on port 7912.

  2. Note its address.

    It looks like http://192.168.1.50:7912: the plain http:// address of that computer on your network. SlicerX refuses https:// addresses and addresses outside your network.

  3. Add it in SlicerX.

    Open Settings, Printer bridge, and find the Spoolman section. It shows once SlicerX is connected to the printer bridge, the part of SlicerX that talks to your printers. Type the address and press Add Spoolman. You can leave out http:// and the port: SlicerX fills in both.

  4. Check that it answers.

    SlicerX tests the address right away. Connected and the number of spools it found mean it works. Test connection checks again later, and Remove Spoolman disconnects it.

    The Spoolman section of the printer bridge settings, connected, with 9 spools found
    Connected to a Spoolman simulator, with the spools it found.
  1. Open the slot.

    In Model, click a filament slot (Edit filament on its swatch) to open its Filament dialog.

  2. Pick the spool.

    The Spool list shows your Spoolman spools with their material and how many grams are left. Type in Search spools to narrow the list; when your spools come from more than one vendor, a vendor filter appears beside it. Picking a spool fills in the slot's material and color. Not linked removes the link.

    The Filament dialog with the Spool list open
    Each spool with its material and the grams left.

If your printer reports which spool sits in a slot, SlicerX uses that link until you pick a different one.

Check before you print

After slicing, the Filament use block in Preview lists what each slot uses. When a linked spool holds less than the plate needs, a warning names the spool, the grams it has left and the grams the plate needs, so you can swap the spool before the print runs out.

The Filament use block warning that a spool has 60 g left and the plate needs 61 g
A linked spool that would run out before the plate is done.

Record what a print used

Record use in Spoolman, under Filament use, subtracts the plate's filament from the linked spools.

The Filament use block in Preview with Record use in Spoolman
What each slot uses, and the button that records it.

When a print started from SlicerX finishes, SlicerX offers the same thing. Either way it asks first: the approval card "Subtract this print from your spools in Spoolman?" lists each spool and amount, with Approve and Deny, and nothing changes until you approve. A failed or canceled print is not subtracted, because how much it used is not known.

The approval card that asks before subtracting from your spools
Nothing is subtracted until you approve.

Reading the inventory never asks for approval. Changing it always does.

Common problems

Message or symptomCause and fix
Not answering: "Spoolman did not answer at that address."The address or port is wrong, or the Spoolman server is off. Fix it and press Test connection.
"Use the plain http:// address of Spoolman on your network."SlicerX talks to Spoolman over plain http:// on your network; https:// addresses are refused.
A spool is missing from the listSpoolman hides archived spools. Unarchive it in Spoolman.
Recording use is refusedAn approval covers exactly the spools and grams it lists. Ask again.