Write RFID tags for your Creality CFS straight from your phone, using the spools in your Spoolman inventory.
Pick a spool, hold a blank tag to the back of your phone, and you're done. SpoolFID links each tag to its spool in Spoolman, and when the tagged spool goes into the CFS, the printer reads the tag, looks the spool up in Spoolman, and fills in the slot's material, color, brand, name and remaining weight for you.
SpoolFID is built for the Jacobean K2 Plus firmware, which can link a CFS slot to a Spoolman spool.
- An Android phone (Android 8.0 or newer) with NFC and MIFARE Classic support. Not every phone has it, because it depends on the NFC chip. SpoolFID checks on launch and shows a warning at the top of the screen if your phone can't do it.
- Blank MIFARE Classic 1K tags with a 4-byte UID. These adhesive MIFARE stickers are known to work: Amazon listing. Listings change, so check that anything you buy is MIFARE Classic 1K with a 4-byte UID.
- QR labels: print them for your spools and scan them with the camera.
- Several tags per spool, two by default, one on each flange (see Tags per spool).
- A Spoolman server your phone can reach on your network. Plain
http://is fine. Use Spoolman 0.27 or newer so tags can be linked to spools; older versions still work for writing tags. - A Creality printer with a CFS running the Jacobean firmware, set up as described in Printer setup.
- Open the Releases page on your phone and download the
latest
SpoolFID-vX.Y.Z.apk. - Open the downloaded file. Android will ask you to allow installs from your browser or file manager the first time. Allow it, then install.
Tap the menu button (three lines, top left) to open the side panel. The back gesture returns to the screen you came from, and only leaves the app from the first screen. Each entry opens a section, and a section with more than one view has tabs along the top:
| Section | Tabs |
|---|---|
| Write | The spool list, with its filters. |
| Read | Read a tag decodes a tag and checks it against Spoolman. Find a spool opens whatever a tag is linked to. Scan a label reads a QR code with the camera. |
| Manage | Spools, Filaments and Manufacturers. |
| Labels | Spools (pick which to print) and Layout (paper, size and what's on the label). |
| Tag audit | Spools whose tags need work. |
| Settings | Spoolman, Writing and Reading. |
- Open Settings and enter your Spoolman address, for example
192.168.1.50:7912. Tap Save & test. It tells you how many spools it found, or why it couldn't connect. - Go to the Write tab. Your spools are listed with their color, material and remaining weight.
- One spool: tap it, then hold a blank tag to the back of the phone.
- Many spools: long-press spools to select them (or tap All), then tap Write N. Tap a fresh tag for each one. After every write the phone vibrates and beeps and moves on to the next. Skip leaves a spool out and Stop ends the session.
- Check the details: the screen shows what's about to be written, including the material, color and weight. Anything approximate is shown in amber.
- Every write is verified. SpoolFID reads the tag back before it counts as done. If you tap the same tag twice in a row it refuses, so one tag can't be used for two spools.
- Tags are linked in Spoolman. Each tag you write is linked to its spool using Spoolman's own tag feature, so Spoolman knows which physical tags belong to which spool. If you reuse a tag that Spoolman had linked to a different spool, the link moves to the new spool and SpoolFID tells you.
Each spool in the list shows how many tags Spoolman has linked to it, so the list always matches Spoolman. A green check with "2 tags" means it's finished, and an amber "1/2 tags" means it still needs another. The list refreshes whenever you return to the app.
The chips above the list narrow it by how many tags each spool has, and each shows how many spools it would list. Your choice is remembered.
| Chip | Shows |
|---|---|
| To do (default) | Spools that still need tags, so the list shows what's left. |
| All | Every spool. |
| Untagged | Spools with no tags yet. |
| Partly tagged | Spools with some tags but not all (only shown when a spool needs more than one tag). |
| Fully tagged | Spools that have every tag they need. |
| Not linked | Spools tagged with an earlier version whose tags aren't linked in Spoolman yet. Only shown while there are some. |
The search box works together with the chips, and any spools you've selected stay visible while you change filters.
Under the tag chips, a second row narrows the list further. Each chip only appears when it would show something.
| Chip | Shows |
|---|---|
| Needs attention | Spools that will come out wrong on the printer: no color, a multi-color filament, a material with no Creality match, a weight that gets rounded to a different size, or spool #1. |
| Low | Spools with less than a fifth of their filament left. |
| Material / Location | Only spools of one material or in one location. |
They combine with each other and with the tag chips.
Put a tag on each flange of the spool and write both for the same spool. Genuine Creality spools carry two identical tags, and the CFS only reads the tag on the side facing its reader. A spool with a single tag may be read one way round and ignored the other. With a tag on both sides it works however you insert it.
SpoolFID does this for you. For each spool it asks for two tags in a row ("tag 1 of 2", then "now a tag for the other side"), writing the same data to both. Settings → Writing → Tags per spool changes how many each spool gets, from 1 to 6. Two is the default.
Before replacing a tag that already holds a different spool, or other CFS data such as a genuine Creality tag, SpoolFID shows what's on it and asks you to confirm. Re-writing the same spool onto its own tag never asks. You can turn this off in Settings for the fastest batch writing.
The Read tab decodes any tag you hold to the phone: the spool ID, material, color and weight. It also asks Spoolman about the tag and tells you where it stands:
- Linked in Spoolman (green): Spoolman has this tag linked to the same spool the tag names. All good.
- Not linked in Spoolman yet (amber): the tag names a spool but Spoolman doesn't know the tag. Tap Link to #N to link it. This is how you add tags you wrote with an earlier version.
- Mismatch (amber): the tag names one spool but Spoolman has the tag linked to another. Tap Link to #N instead to fix Spoolman, or re-write the tag if the tag is the one that's wrong.
Use it to check a tag before putting the spool in the printer.
The Manage tab edits your Spoolman inventory directly, so you don't need the web page to add a spool or fix a detail. Everything is saved to Spoolman as you go; SpoolFID keeps no copy of its own.
Pick the Spools, Filaments or Manufacturers tab, search the list, and tap an entry to edit it. The Add button creates a new one.
- Manufacturers have a name, an empty spool weight and a comment. Deleting one removes it from Spoolman.
- Filaments have a name, manufacturer, material, color (or several, for multi-color), net and spool weight, diameter, density, temperatures, price, article number and comment. Density fills in from the material, and the material and manufacturer suggest what you already use. Start from the filament database searches the community filament list that Spoolman provides and fills the form in for you, creating the manufacturer if it's new. On an existing filament, Add a spool of this filament and Duplicate this filament save typing.
- Spools belong to a filament and have a starting, spool and remaining weight, price, location, lot number and comment. Switch Archived on to hide a spool without losing its history; the Archived chip on the list shows them again.
If Spoolman refuses a change, such as deleting a filament that still has spools, the app shows its reason.
Other things you can do from a spool's page:
- Weigh in: on a spool, enter the scale reading of the whole spool and tap Update. Spoolman subtracts the empty spool's weight to get the remaining filament.
- Several spools at once: when adding a spool, How many spools creates that many identical ones. Duplicate this spool starts a new one from an existing spool, full and without tags.
When you search for a filament, the Spoolman database's matches appear under your own, as they do in Spoolman's web page. That works when choosing a filament for a spool and when searching the Filaments tab. Tap a database match to add it, and its manufacturer if that's new; for a spool, it's then used for that spool.
To browse instead of search:
Spoolman keeps a public database of manufacturers and filaments. On the Filaments or Manufacturers tab, Add manufacturers and filaments from the database lists every manufacturer in it, marked New or In Spoolman. Open one to see its filaments, tick the ones you want (Select all new ticks every one you don't have yet) and tap Add. If you don't have the manufacturer yet, it's created first. Add manufacturer adds just the manufacturer. Filaments you've already added from the database show as Added.
- Find a spool (Read → Find a spool): hold any tag to the phone to open the spool or filament it is linked to.
- Tag audit (its own section): lists the spools whose tags need work: too few tags, tags from version 1.0 that aren't linked, tags still on an archived spool, and tags on spool #1.
Open a spool or filament and its Tags section lists every tag Spoolman has linked to it.
- Link a tag by scanning it links any tag you hold to the phone, without writing to it. If Spoolman already has that tag on something else, it's moved here and you're told where it came from.
- The bin next to a tag unlinks it in Spoolman. The tag keeps what's written on it.
- On a spool, Write tags for this spool starts the usual write flow for it.
Besides RFID tags, SpoolFID can print and scan QR labels for your spools. They use the same codes as Spoolman's own labels, so a label printed here works in Spoolman's scanner, and one printed from Spoolman's page works here.
Open Labels, tick the spools on the Spools tab and tap Print. Android's print dialog opens: pick a printer, or Save as PDF. A single spool's page also has Print a QR label for this spool.
The Layout tab sets:
| Setting | What it does |
|---|---|
| Layout | Sheet puts several labels on an A4 page with a line to cut along. Label printer makes each page the size of one label. |
| Label size | A preset (30×20 up to 100×50 mm) or any width and height from 15 to 150 mm. For a sheet it shows how many fit. |
| QR code holds a web link | Off: Spoolman's spool code. On: a link to the spool's page in Spoolman, which any phone camera can open. Spoolman's scanner and SpoolFID read both. |
| Show the manufacturer, Show the material | What goes under the spool's name. |
Each label has the QR code, the spool's number, name, a dot in the filament's color and the details you chose. Printing needs a printer or print service set up on your phone, or just save the PDF.
Read → Scan a label opens the camera. Hold a QR label from Spoolman or SpoolFID in view and the spool opens, ready to edit, weigh in or write tags for. The first time, Android asks to allow the camera. Nothing is recorded or sent anywhere; the camera is only used for this screen, and everything else works without it.
With Report scans to Spoolman on, each tag you scan on the Read tab is reported to Spoolman as if from a tag reader, which shows in the Spoolman web page in your browser. The page only jumps to the spool when all of these hold:
- In the page's scanner, SpoolFID is chosen as the reader and auto-navigate is on.
- The page is showing its dashboard (the home page). On any other page it only shows a message.
- The scanner and add dialogs are closed, and no text box has focus.
- The tag is linked to a spool or filament in Spoolman. If it isn't, you get a message saying so.
Under the switch in Settings, SpoolFID shows what Spoolman made of the last scan, such as "spool #12", which tells you whether the tag was matched.
Settings has three tabs: Spoolman (the address and tag linking), Writing and Reading.
| Setting | What it does |
|---|---|
| Spoolman address | Where your Spoolman server is. |
| Tags per spool | How many tags to write for each spool, 1 to 6. Two by default, one for each flange. |
| Link tags in Spoolman | Links every tag you write to its spool in Spoolman, and takes the tag count in the list from there. On by default. |
| Link tags when reading | On the Read tab, links a tag to the spool it names as soon as you scan it, if Spoolman doesn't have it yet. Never moves a tag from another spool. Off by default. |
| Report scans to Spoolman | Tells Spoolman about each tag you scan on the Read tab, the way a tag reader would. Needs a recent Spoolman. Off by default. See Jumping to a spool in the browser. |
| Keep screen on | Stops the display sleeping while you write or read tags. On by default. |
| Close "Done" screen after | After the last tag, returns to the list after this many seconds, 0 to 60. 3 by default; 0 leaves it open. The Done button shows the countdown and still works. |
| Confirm before overwriting | Ask before replacing a tag that already has data. On by default. |
SpoolFID writes the tags. For the printer to use them, check these on the printer side:
- Connect Moonraker to Spoolman. In
moonraker.conf, add a[spoolman]section withserver:set to your Spoolman address. You can confirm it's working athttp://<printer>:7125/server/spoolman/status, which should show"spoolman_connected": true. - Turn on RFID reading. In Fluidd, open Filament Box, click the cog, and enable Read RFID on insertion and Read RFID after Klipper starts. Both are off by default.
- Give every spool a material and a color in Spoolman, and don't archive it. Without those, the printer ignores Spoolman and uses only what's on the tag (a "Generic" slot with no Spoolman link).
- Use spool ID 2 or higher (see Spool #1).
- The CFS reads a tag when a spool is inserted, with the filament unloaded. To update a slot, pull the spool all the way out, wait a few seconds, and push it back in.
- A restart of Klipper or the host does not make the CFS re-read slots it already has data for. To force every slot to be re-read, switch the printer's power off for about 30 seconds and back on.
- If a spool's tags can't be read, its slot keeps showing the previous spool's details. A swapped spool that still shows the old color usually means its tag isn't being read. Check both tags with the Read tab.
- Watch the Fluidd console while you insert a spool. A working tag prints, in order:
RFID tag read for …, thenfetching Spoolman ID N, thenSpoolman ID N profile applied.- No
RFID tag readline: the CFS isn't seeing the tag. Check that both flanges have a tag and that they read on your phone. fetchingbut thenunavailable or incomplete: the Spoolman lookup failed. Check the Moonraker connection above, and that the spool has a material and a color.
- No
BOX_DEBUGin the console shows what the CFS has stored for each slot. A slot with no readable tag showsunknown.- Fill a slot without a tag using Select spool in Filament Box, or
_BOX_SLOT_SET SLOT=<index> MATERIAL=PLA COLOR=#RRGGBB BRAND=… NAME=… SPOOLMAN_ID=<id>. Clear a slot with_BOX_SLOT_CLEAR SLOT=<index>. Slot indices run 0 to 7 across the two boxes.
The firmware treats a spool ID of 0 or 1 as "no spool ID" and skips the Spoolman lookup. SpoolFID writes
spool #1 correctly and warns you, but the printer will ignore that tag.
Spoolman can't renumber spools. To use that spool, create a new one (it gets the next free ID) and archive the old one, or just leave #1 unused. IDs from 2 up to 999999 work.
The tag needs a Creality material ID. SpoolFID maps your Spoolman material (PLA, PETG, ABS, TPU and common variants like "PLA+") to Creality's generic profile for that family. If nothing matches, it uses Generic PLA and warns you. With the Jacobean firmware, Spoolman's own data takes priority over the tag's material.
Spoolman stores multi-color filaments without a single color. SpoolFID writes the first color and warns you, but the Jacobean firmware only links a spool to Spoolman when the filament has one color set. Until you set one in Spoolman, that slot won't show the Spoolman name or remaining weight.
Tags can only hold 250 g, 500 g, 600 g, 750 g or 1000 g. A spool's weight is rounded to the nearest of those. If Spoolman has no weight for it, 1000 g is assumed.
Version 1.0 didn't link tags in Spoolman; it only kept a count in a custom "CFS tags written" field. Tags you wrote then work fine in the printer, and SpoolFID still remembers them: those spools show "2 tags · not linked" and count as tagged, so they stay out of your To do list. Spoolman just doesn't know which physical tags they are yet.
To link them, use the Not linked chip to see which spools are left, then hold each of their tags to the phone on the Read tab and tap Link to #N. Once a tag is linked, Spoolman's own tag list takes over the count for that spool. When everything is linked you can delete the old field in Spoolman under Settings → Extra Fields.
SpoolFID needs to reach Spoolman while you use it. There's no offline mode.
Copyright (C) 2026 mitt3n
SpoolFID is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License v3.0 as published by the Free Software Foundation. It is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. See the license for details.