Releases: dmuth23/spooltap
Release list
v0.3.2 — scans confirm the spool: name + grams remaining
Right-spool confirmation on every scan
Every place a spool tag resolves now shows the spool's name and remaining weight, e.g. spool #12 (Polymaker Orange PLA, 612g left) — so you can sanity-check the physical spool in your hand against what the tag says it is. A swapped or mislabeled tag shows up immediately as an impossible weight or wrong color.
Surfaces updated:
- Tag-in-hand chip on the status banner (
in hand: spool #12 (…, 612g left)) - Assign — both the "Assigning…" working message and the success message (tap path and dropdown path)
- Modify — the "Opened … in Modify" message when a scan loads a spool
- Bind preview — the "already on …" / "that tag is on …" warnings identify the spool fully
No dashboard changes, no breaking changes. Upgrade: HACS update → restart HA. (Includes everything in v0.3.1.)
v0.3.1 — slot strip grouped per AMS, gradient background fixed
Two visual fixes to the 0.3.0 glass dashboard, found on first live install:
- AMS slot strip regrouped — one labeled row per AMS unit (e.g. LEFT AMS / RIGHT AMS / EXTERNAL) with column-aligned chips, instead of one arbitrary flex-wrap across all slots. Rows never wrap; chips shrink on narrow screens.
- View gradient now renders — HA wraps the object-form
background.imageinurl(), which silently breaks CSS gradients; the view now uses the string form, so the navy radial background actually shows.
Upgrading from 0.3.0: HACS update → restart → run spooltap.install_dashboard with force: true once (skip the force step if your dashboard was already refreshed another way). From pre-0.3.0, follow the 0.3.0 upgrade notes first.
v0.3.0 — glass dashboard + structured status
SpoolTap 0.3.0 — the glass dashboard + a status pipeline that tells you what happened
The dashboard, redesigned
The shipped dashboard is now a dark "glass cockpit": frosted cards on a navy gradient, one cyan accent, and semantic color everywhere. Phone-first; widens to two columns on a PC.
- Hero status banner — every action outcome shows as a color-coded badge (green DONE · amber ARMED/CHECK · red FAILED · cyan WORKING, pulsing while something's in flight) with the full message and context chips: the tag in your hand, the armed slot, and how old the message is.
- Live AMS slot strip (Assign) — one chip per slot in the spool's actual filament color, the armed slot glows amber, a cyan dot marks slots with an NFC tag bound. Auto-derived from Bambuddy; adapts to any AMS count.
- Inventory, visual (Spools) — color swatches + remaining-filament bars (green/amber/red by fill) replace the markdown tables, with an up-front warning card listing spools that have no slicer profile linked.
- Mode pills, bind-mode glow, slot-tag list — all restyled to match.
Dependency change: the dashboard now uses button-card + card-mod (HACS → Frontend). Mushroom is no longer required.
Status messages, properly structured
- BREAKING:
sensor.spooltap_status's state is now the level — one ofIdle / Ready / Armed / Working / Success / Warning / Error / Info(a proper enum you can trigger automations on, e.g.to: "Error"). The human message moved to themessageattribute, joined byupdated_at(freshness) andbusy. Previously the state was the message string itself; if you templated on it, readstate_attr('sensor.spooltap_status','message'). - Friendly errors — a failed Bambuddy call now reports Bambuddy's own detail (or a clean "unreachable / timed out" line) instead of a raw exception dump.
- Working states + double-press guard — Assign/Bind/Save/Archive now show "…ing" feedback the moment you press, and a second press while a write is in flight is ignored.
- Consistent tag naming — success messages use the HA tag's friendly name (the label you read off the spool), matching the bind preview.
Upgrading
- Install button-card (HACS → Frontend) if you don't have it.
- HACS → update SpoolTap → restart HA.
- Run
spooltap.install_dashboardwithforce: trueonce — the auto-install never overwrites an existing dashboard.
See DEPLOY.md → "Upgrading to 0.3.0" for the full notes.
v0.2.5 — plain-text status card
Replaces status/card emoji that showed as empty boxes on some HA frontends with plain text (the pencil/mode icon and dashes are unaffected). Update in HACS, restart, then run the spooltap.install_dashboard service with force: true once to refresh the card.
v0.2.4 — clearer pickers + bind safety
Pick lists
- Every spool picker now shows the NFC tag's name (the label you gave the tag when you enrolled it) next to the spool — so you can pick the right spool by hand when you can't scan.
- Shorter dash separators for a tighter, more legible dropdown.
Bind safety
- Pressing Bind now previews the exact tag it will commit — and warns if that tag belongs to an AMS slot/tray.
- A fresh scan takes over from any leftover dropdown pick, so the tag you scan is the tag that binds.
- Binding a slot/tray tag onto a spool (or a live spool tag onto a slot) is now refused.
Update in HACS, then restart Home Assistant.
v0.2.3 — SpoolTap V2
First release in the fresh public repo (development history lives in the private companion repo). Phone-NFC filament tracking for Home Assistant, native to Bambuddy: two-tap spool→slot assignment, auto-installed dashboard, weight recertification, 13 services. See the README for install.