The reader works on its own. Sending its scans to your spools, Find by color and the rest need a free account: sign up or sign in.
Same batch or not?
Scan two spools of the same color and the spool page's Batch check says “Same batch”, “Slight difference” or “Different batch” — finer than your eye can see.
Find spools by color
Scan a swatch, a strand of filament, or a printed part in Find by color (needs an account) to see your closest spools — including “which spool was this part printed with?”
Match a print file
Drop a .3mf or .gcode on Match a file (needs an account) (Pro) to see which of your spools fit each color it uses — painted-on colors and supports included. Spools you've scanned are compared using your reader's measurement.
Similar spools you own
Each spool's page lists your other spools close enough to use instead — handy when one runs out mid-project.
A color for unlabeled spools
A spool that isn't linked to the catalog shows the color you scanned, instead of a guess.
Comparing two scans is very accurate; a scan's absolute color is approximate — see What it's good at.
Assembled Color Inspectors are $99 at 3dcreator.shop.
They're built to order, not kept in stock: the parts are bought and each reader is assembled once your order comes in, so expect about 1–2 weeks before it ships.
Step-by-step: Assemble a Color Inspector →
The reader's color correction was fitted to one optical design, so a build has to match it to read accurately:
- The v2 hardware, exactly: a Seeed XIAO ESP32-S3 with the 1.14″ display, and an AS7341 sensor board facing down with its wires soldered on (connector removed). Print the v2 body with the built-in 8 mm nose, the carrier, housing, two button caps, swatch tray, strand tray and probe plate. A different nose or sensor board would need its own correction.
- The spring-tongue swatch tray — the current version. It presses the swatch flat against the nose; any gap reads noticeably darker.
- Reference swatches: Bambu Lab PLA Matte Ivory White and PLA Matte Charcoal, and no others. Their colors are built into the firmware, so any other white or black shifts every reading.
- Print the references — and anything you scan in Swatch mode — with the same swatch model (the hanging-tag swatch, about 1.4 mm thick as printed).
- Flash it from the flasher.
- Print files (enclosure and swatches) are on MakerWorld: get them here.
On its own, the reader scans, keeps its last 300 scans and shows them on its own web page, where you can name or delete them, compare two, or download a spreadsheet. Open the page on your home WiFi, or join the reader's hotspot when there's no WiFi: on the reader, tap C for Info, then tap B for Network, then tap B for the web page, which shows a QR code for it. No account needed.
Add a 3D Spool Tracker API key and scans also go to your spools, with Find by color and Compare on the website.
Without an API key, the reader never contacts 3D Spool Tracker, not even to check for updates (from firmware 0.9.5). To update it, reinstall from the flasher; leaving “Erase device” unticked keeps its calibration, WiFi and scans. With a key, it updates over WiFi.
Reinstalling? When the installer asks “Erase device?”, leave it unticked to keep WiFi, the link to your account and your calibration. Tick it to start over.
- On first start the reader offers WiFi setup: scan its QR code (or join the
ColorInspector-Setup-xxxxnetwork) and open192.168.4.1. Tap C instead to skip and stay offline. To set it up later, tap C for Info, then tap B for Network, then tap A (or hold A while switching the reader on). - Pick your home WiFi and, optionally, paste an API key from Settings → API keys (needs an account).
- With an API key, the reader appears on Devices (needs an account) as “Color Inspector 1”. Without one it stays on its own.
The reader has three modes. Use the one that matches what you're scanning:
- Swatch — a flat printed swatch in the slot. The most accurate reading.
- Strand — a length of filament laid in the groove under the black card, straight off the spool. Handy when you don't have a printed swatch.
- Probe — press the nose flat onto a printed part (probe plate on). Probe readings can be used to search your spools (“which spool was this printed with?” on Find by color); they're never saved to a spool.
To switch modes, tap B — the screen cycles SWATCH → STRAND → PROBE, and the reader remembers the mode. To compare two samples on the reader itself, long press A.
Each mode is calibrated separately, and the same filament reads slightly differently as a swatch, a strand or a part — compare scans taken in the same mode.
Each mode — Swatch, Strand and Probe — is calibrated separately, so calibrate the ones you'll use. To calibrate the current mode, long press B, then scan the white reference (Ivory) and the Charcoal one when the screen asks.
Use the references in the same form as what you'll scan in that mode:
- Swatch — the Ivory and Charcoal swatches in the swatch tray.
- Strand — Ivory and Charcoal filament in the strand tray.
- Probe — the two probe calibration plaques (25 × 25 × 5 mm, in the print files), with the probe plate on.
Recalibrate after reassembling the reader or changing a tray, or if a swatch you know starts reading differently.
Is the calibration still good? To check, long press B for the calibration screen, put in the white reference and tap C (check, not calibrate), then the Charcoal one and tap C. The reader shows how far each reads from its stored calibration: OK up to 0.8 ΔE, slight up to 1.5, and more than that means recalibrate.
What to expect once calibrated is under What it's good at: comparing two scans is very accurate; the color itself is approximate. A second reader built the same way should read close to the first, but that hasn't been measured yet.
Scan to check, sort and match your filament — same batch or not, which spools are interchangeable, what you already own that's close to this one.
- Comparing is very accurate. Two scans on the same reader agree to within a fraction of a ΔE — finer than your eye can see — so batch checks and substitutes between scanned spools are reliable.
- Absolute color is approximate — about 7 ΔE on average, more on warm, saturated colors (yellow, orange, pink), which read a little dark and dull. Light spreads sideways inside colored plastic and some escapes the reader's small view.
So a scan is compared with a catalog color only loosely (“likely the same color” under ΔE 5, “probably close” to 7, then “similar color family”; never “looks identical”), and it doesn't change the color shown for a spool that's linked to the catalog — the manufacturer's color looks closer to the real filament. Your scan is still shown beside it on the spool's page.
A scan is only sent somewhere when the site is waiting for one. Otherwise the reader just shows the color on its screen (“No spool waiting”) and nothing is saved.
Scan a spool's color
- Open the spool and tap Scan color. The page waits for 10 minutes.
- Put the swatch (or a strand) in the reader and tap A. The reader shows which spool it saved to.
- The spool page updates on its own — no need to refresh.
Find spools like a swatch, filament or printed part
- Open Find by color (needs an account), choose Scan with your readerand tap Start a scan.
- Scan a swatch or a strand of filament the same way — or, in Probe mode, press the nose onto a printed part. The reader shows “Sent to search” and your closest spools appear. A search scan isn't saved to any spool. A printed part reads differently from a swatch, so its matches are approximate.
- A probe scan only works for search: on a spool's Scan color the reader shows “Probe: search only” and the spool keeps waiting for a swatch or strand.
Clear on a spool goes back to the catalog color; your scan history is kept.
Sparkle, silk and translucent filaments can't be fully captured by a color sensor, so their scanned color is approximate.