Frequently Asked Questions
Everything you need to know about Spoolytracker and managing your filaments.
What is Spoolytracker?
Is the service free?
How does NFC tracking (TigerTags) work?
Which printers are compatible?
How do I connect OrcaSlicer to Spoolytracker?
Settings > Integrations, then create an OrcaSlicer key.
Available from Settings > Downloads.
In OrcaSlicer: Prepare > Process > Others.
python "C:\path\to\spooly_orca.py" --api-url https://app.spoolytracker.com --api-key sk_orca_xxx --commit
--commit, the script only analyzes the G-code. With --commit, it also records consumption on the suggested spool.
How do I connect Home Assistant to SpoolyTracker?
The Home Assistant integration connects SpoolyTracker with an API key, then lets your automations record filament consumption automatically.
HACS > menu > Custom repositories, add the SpoolyTracker repo, category Integration.
Install the integration from HACS, then restart Home Assistant.
Settings > Devices & services > Add integration > SpoolyTracker.
- Choose Cloud for the official
https://api.spoolytracker.comservice. - Choose Other for a self-hosted instance, entering the base URL without
/public-api/v1. - Generate a SpoolyTracker key with
filaments:read,stock:read,consumption:read,consumption:writeandanalytics:readscopes.
action: spoolytracker.log_consumption
data:
printer_name: "Workshop"
grams_used: 42
ams_unit: 1
ams_slot: 0
spool_id, AMS mapping, active spool select or metadata. If the spool is ambiguous, it refuses to log silently and emits a resolution event.
Full guide: spoolytracker-homeassistant.
Is my data secure?
Can I use Spoolytracker without an internet connection?
How does the AI assistant help me?
Spool AI is a real copilot for your workshop. It understands plain-language questions and acts on your data (always asking for confirmation before writing anything):
- Natural-language inventory — "Which red filament is the fullest?", "How much PETG do I have left?"
- Run-out forecasting — estimates when you'll run out and builds a restock list sorted by urgency.
- Project feasibility — "Do I have enough material for this part?" with a per-spool breakdown.
- Consumption logging — the AI offers to deduct used weight from the right spool, changing nothing until you confirm.
- Calibration assistant — describe your test print (temperature tower, flow, VFA…) and the AI computes the right settings, then applies them straight to your filament.
Available free for everyday questions, and in Pro for advanced actions and the calibration assistant.
What are the calibration editors / calculators for?
SpoolyTracker ships calibration calculators right inside each spool (web and mobile). Run a test print, read the result, and the calculator turns it into ready-to-use settings:
- Max volumetric flow — from the flow test, so you stop under-extruding at high speed.
- Flow ratio — for walls with accurate dimensions.
- Max speed by temperature (VFA) — spot the notch where it breaks down; the calculator derives the maximum speed and adds a conditional temperature rule (max speed + temperature) to your filament.
- Pressure advance, retraction, temperature tower…
A dedicated button opens the calculators from any inventory row, with a reminder of the spool being calibrated. Once confirmed, the value is written to the filament (with confirmation if it replaces an existing setting) and flows into your exported profiles.
How do I import a filament config into Bambu Studio or OrcaSlicer?
Every spool can be exported as a JSON filament profile that imports straight into OrcaSlicer and Bambu Studio — temperatures, flow, speeds, retraction and conditional rules included.
In the inventory, use the "Export profile" button (JSON icon) on the spool.
Filament tab > import icon, pick the .json file.
The profile shows up in your filament list, ready to go.
type: filament, compatible with every printer) for an error-free import. Calibrate once in SpoolyTracker, reuse everywhere.
Can't find the answer?
Our support team is here to help. Don't hesitate to contact us directly.
Contact Us