SpoolHub guide

Everything you need to set up SpoolHub and keep an accurate picture of your filament, spools, and prints across every 3D printer.

Getting started

SpoolHub runs in your browser and talks to your 3D printers over your local network. To begin:

  1. Open the dashboard and create an account (email + password). Your printers, filaments, and spools are private to your account.
  2. Add your first printer (see below) so SpoolHub can start gathering its print history.
  3. Build a small filament library and create the spools you actually have on the shelf.
Note: the dashboard talks to your printers directly from your browser, so keep a tab open on a device that's on the same network as the printers for live data and history syncing.

Printers

Go to Printers and add each machine:

  • Name — a label you'll recognise.
  • Address — the printer's LAN address as host or host:port (e.g. 192.168.1.14 or 192.168.1.14:9999). If you omit the port, the default WebSocket port is used.
  • Model — optional, picked from the dropdown.
  • Active — when on, your browser connects to the printer and gathers its history. Turn it off to pause a machine without deleting it.

Browsing files & thumbnails

For an active, reachable printer you can browse the gcode files on the device and see job thumbnails. Thumbnails are served by the printer itself over your LAN.

Deleting a printer also removes its jobs, files, and statistics. Any spool that was loaded into it is simply ejected, not deleted.

Filament library

The Filaments page is your catalogue of filament types — independent of any physical spool. Record:

  • Producer & name — who makes it and how it's labelled.
  • Material (PLA, PETG, ABS, …) and diameter (1.75 or 2.85 mm).
  • Colour, net weight (g) and length (m), and optional empty spool weight.
  • Notes for the quirks worth remembering (temps, drying, etc.).

A filament can't be deleted while spools still reference it.

Spools

A spool is a physical reel on your shelf. Each one is assigned a filament from the library and tracks how much is left.

  • Filament — the type on this reel. Picking one pre-fills the remaining length with its nominal length.
  • Remaining length — metres left on the reel. Locked while the spool is loaded into a printer, because SpoolHub maintains it automatically then.
  • Load into a printer — a spool sits in at most one printer, and a printer holds at most one spool. Loading a spool ejects whatever was there.
  • Archive empties to keep them out of the active list without losing their history.

A spool can't be deleted while it's loaded into a printer or has recorded jobs.

Automatic usage

As prints finish, SpoolHub subtracts the filament they used from the spool that was loaded in that printer — no manual bookkeeping. A job only counts against a spool if the spool was loaded before the job started, so swapping reels keeps the numbers honest.

History & files

Print History lists every recorded job with its thumbnail, status, material used, duration, and start/finish times. Lifetime totals come straight from each printer, alongside a sum computed from the recorded jobs.

Job status is inferred:

  • Success — the printer reported a finish time.
  • Failed — unfinished, used material, and not the current print.
  • Unfinished — the active print, or one aborted before extruding.

The Files page rolls jobs up per gcode file, so you can see how often each model printed and its success rate across all your printers.

Live monitoring

The Overview shows each printer's live status — progress, elapsed and remaining time, and material used — read directly over your network while the dashboard tab is open.

Heads up: because the browser connects to your printers directly, live data and history syncing only happen while a dashboard tab is open on a device on the same network as the printers.

Accounts & privacy

Everything you add — printers, filaments, spools, and their jobs — is private to your account. Other users can't see your data. Your printer data is gathered by your own browser over your LAN and stored against your account.

FAQ

Do I need to install anything on my printer?

No. SpoolHub reads the history your printer already keeps, over your local network.

Why did a printer stop updating?

Make sure it's marked Active, reachable at its address, and that a dashboard tab is open on the same network.

Why is remaining length greyed out?

The spool is loaded into a printer, so SpoolHub manages its remaining length automatically. Eject it to edit by hand.

Can I run several printers?

Yes — add as many as you like and switch between them, or view all at once, from the dashboard.