# Changelog All notable changes to SpoolmanSync will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [2.1.1] - 2026-11-14 ### Security - Printer setup passed the flow ID it was sent straight into a request to Home Assistant, so a crafted request could make SpoolmanSync call any Home Assistant service with its login, such as one that unlocks a lock. Every ID SpoolmanSync puts into a Home Assistant or Spoolman request is now checked. - SpoolmanSync refuses API requests that another website makes through your browser. It has no login of its own, so a page you visited could change its settings, or use the hole above. - URLs entered in Settings must start with http:// or https://, and one padded with thousands of slashes no longer ties up the server. - The images no longer contain the build and test tools (about 230 MB less), and Prisma no longer contacts its servers at every start. They are built with npm 12, which runs install scripts only for the packages that need one (better-sqlite3 and Prisma), and the build stops if a new dependency brings another. - The app and add-on images run on Node.js 24 (LTS). They ran on Node.js 20, which reached end of life in April 2026 and no longer gets security fixes. - Updated ws to 8.23.0, which fixes a denial of service: a peer that floods pings without reading the replies could exhaust memory. SpoolmanSync uses it for its Home Assistant connection. - Updated Next.js to 16.4.6, React to 19.3.1, Prisma to 7.10.1 and the other dependencies, and moved a lint tool onto a minimatch release that fixes a published denial of service (GHSA-g3hv-75wg-m249). ## [2.1.0] - 2026-11-14 > Upgrade note for H3C owners: once SpoolmanSync finds all nine AMS 3H trays, the dashboard asks you to reconfigure automations. Do it, so tray changes in trays 5 to 9 are picked up too. ### Added - Spoolman's own NFC tags (#89). Spoolman 0.27 links a tag to a spool by the tag's ID, and SpoolmanSync now recognizes those tags: tap one on the Scan page's new **Read NFC Tag** card (Chrome on Android), type its ID under **Manual Entry**, or read it with a kiosk's USB reader, and that spool opens. On the dashboard, a tray's assign dialog has a **Read NFC tag** button too: hold the spool's tag to the phone and the spool goes in that tray. A tag Spoolman doesn't know yet can be linked to a spool in either place. Tags written with SpoolmanSync's NFC writer are linked to their spool in Spoolman too, so Spoolman, and tools that read tags through it, know them as well. A sticker written by an earlier version is linked the first time it is read, without rewriting it. - Tags and QR codes for trays and storage slots (#97). The Scan page's new **Slot Tags** card gives every AMS tray, external spool and storage slot a link to write to a tag or show as a QR code. Scan a spool and then the slot it goes in, in either order within ten minutes, and SpoolmanSync offers to assign it there in one tap. This works on an iPhone too, with tags written by an app such as NFC Tools. - Bambu Lab H3C with the AMS 3H (#98, contributed by @sepffuzzball in #99). All nine trays are listed, assignable and tracked; until now only the first four showed, as "AMS 1". ha-bambulab does not report the slicer's per-tray split for the AMS 3H, so a finished multi-colour print from it is shared out by which tray fed when. Spoolman locations written while it showed as "AMS 1" move to "AMS 3H". ### Fixed - A Bambu PAHT-CF spool no longer shows a "Wrong spool?" warning (#102). Its tag reports the broader type PA-CF, so the material in the filament's name (Bambu PAHT-CF) now counts as a match as well. - Stopping or updating SpoolmanSync no longer cuts off a deduction being written (#94, contributed by @JanJoh). It finishes the write, saves the prints in progress and exits cleanly, within the stop timeout. - An empty external spool slot that briefly reports another spool's serial no longer moves that spool onto it (#93, contributed by @JanJoh), which took the spool off the tray it was really in, so its next print was flagged instead of deducted. A tray holding a spool the printer has not identified ("?") keeps its assignment, and the log says so. - The NFC writer says up front why it cannot write tags (#84): inside the Home Assistant sidebar or app, on an http:// page, or in a browser without Web NFC. From the sidebar it offers to open SpoolmanSync on its own page, and in every case a spool's link can still be copied for an NFC app such as NFC Tools. ## [2.0.1] - 2026-11-10 > Updating from 1.6.x? Follow the 2.0.0 upgrade note below as well. ### Security - Updated Next.js from 16.3.1 to 16.4.5, which fixes several published advisories, among them unauthenticated remote code execution through the image optimization API. Test tools with open advisories, which were also in the image, are updated as well. ## [2.0.0] - 2026-11-08 > Upgrade note: filament usage is now tracked by SpoolmanSync itself. After updating, re-run **Configure Automations** (in external mode, replace the SpoolmanSync YAML in Home Assistant instead) and restart Home Assistant. Until you do, the old usage automations are ignored, so nothing is deducted twice, and once they are gone SpoolmanSync removes their leftover entities itself. Run one SpoolmanSync per Home Assistant and Spoolman, since every install connected to them now deducts usage. ### Changed - Filament usage is tracked inside SpoolmanSync instead of by generated Home Assistant YAML (#83). Spoolman is updated as each print runs, and a finished Bambu Lab print is settled to the slicer's per-tray figures, purge and prime tower included. Every print is listed under **Reports → Recent Prints** with what it deducted, and the Logs page shows each print as it starts. The generated automations now only report tray changes. - Bambu Lab usage counts from when the printer starts printing. Heating, levelling and calibrating move the progress but use next to no filament, so a print cancelled during them is not charged, and one cancelled part way is charged for its share of the printing. - Settings puts the Spoolman card right under Home Assistant and explains the Dashboard Display options in tooltips. Dashboard tray cards are all one height, and the dashboard and Logs Refresh buttons show that they worked. ### Fixed - A Home Assistant restart, a printer dropout or a failed print no longer over- or under-charges a print (#83): only readings the printer reports during the print count. Usage owed while Spoolman is unreachable is written once it is back, and a deduction Spoolman may have missed (a timeout) is flagged rather than sent twice. - Anything SpoolmanSync cannot account for is flagged on the print and in the Logs instead of guessed: a weight Home Assistant never reported (#90, where the old meter charged the previous print's weight), a tray with no spool or several, skipped objects, and a print that ran while SpoolmanSync was down. - Bambu Lab: a job resumed after power loss is charged only for the rest of it, and a print mixing AMS trays with the external spool gives the external spool the part the slicer's figures leave out. - Creality: usage is charged to the CFS slot that fed it and converted with the spool's density and diameter, a job is counted once when the printer reports it complete early or resumes it after a power loss, and printers whose entity ids end in `_2` (or higher) are discovered. - Auto-configure no longer deletes configuration below its block in configuration.yaml or, in embedded mode, shadows your own keys. The tray-change automation loads for printers without an AMS or CFS, and a filament name with a double quote no longer breaks it. - A spool assigned before its tray's entity was renamed is no longer moved to another AMS's or printer's tray, and a printer added or a Home Assistant connection changed in Settings takes effect at once. - In the add-on, nested pages load through the sidebar again, and the add-on's port can no longer collide with the ingress port. - A database upgrade interrupted part way is retried on the next start, and an interrupted update of the embedded image's integrations keeps the installed ones. - Requests to Spoolman time out instead of hanging, two webhook secrets can no longer be issued at once, and the Scan page opens at the top. ## [1.6.14] - 2026-10-02 ### Added - New "Location detail" setting, under the Spoolman location sync toggle in Settings (#85). Spools can now be filed by AMS unit ("X1C - AMS 1") instead of by individual tray ("X1C - AMS 1 Tray 3"), so everything loaded in one AMS shares a location. The per-tray labels stay the default, so nothing changes unless you pick the new option. Switching either way moves the locations SpoolmanSync has already written, the next time the dashboard loads. External spools and printers without an AMS keep their own labels either way, and a location you set by hand is never touched. ### Fixed - Removing a printer from SpoolmanSync no longer hides unrelated printers (#86). The dashboard matched the removed printer's config entry title anywhere in another printer's name or entity id, so removing one titled "A1" also hid an X2D and an A2L whose serials contain those letters. Printers are now matched on their config entry id, which is exact. The same change makes removing a Creality printer work, since its default entry title ("Creality Printer (WS)") matched nothing at all and left the printer on the dashboard, and it stops the cleanup that runs on removal from deleting another printer's automation record. - The two external spool slots on dual-nozzle printers (H2D, H2C, X2D) can be told apart (#87, contributed by @misch2). Both showed as "External" and shared a single Spoolman location, so there was no way to tell which spool was in which. They are now "External 1" and "External 2", or whatever you renamed the slots to in Home Assistant. Printers with a single external spool are unchanged, and locations already written for a dual-slot printer move to the numbered label on the next dashboard load. ## [1.6.13] - 2026-09-20 ### Fixed - Bambu Lab printers can be added in LAN mode again from the Add Printer dialog (#82). The form showed a blank, required "Advanced" text box that failed with "Advanced: required key not provided" no matter what was typed in it, so LAN printers could only be added from Home Assistant directly. Advanced is now a collapsible section holding its two real options, "Disable SSL Verification" and "Enable Firmware Update". Both start off, and most printers need neither. - LAN connection failures now show a readable message (for example, a rejected access code or an unreachable address) instead of a raw code like `cannot_connect_local_unknown`. ## [1.6.12] - 2026-09-09 > Upgrade note: re-run Auto-configure / regenerate your Home Assistant automations, then **fully restart Home Assistant**. A reload is not enough this time, because the `utility_meter` definition itself changed. ### Fixed - Filament used before a printer dropped off the network is no longer thrown away (#78). When a printer went offline for more than two minutes, the usage counter was reset to zero without ever deducting what it held, so everything used up to that point vanished. One user reconciled 105 g lost in a single overnight dropout against a physical weigh-in of the spool. The offline step now deducts the usage first and then resets. The reset is kept, because that is what stops a power-on from deducting the last print a second time. - Two other spots reset the counter without deducting, when a tray change or the end of a print could not work out which tray the filament belonged to. Those still reset, since holding on to grams we cannot attribute would only deduct them from the next spool, but they now log a warning instead of a debug message so the loss is visible instead of silent. ## [1.6.11] - 2026-09-08 > Upgrade note: re-run Auto-configure / regenerate your Home Assistant automations to pick up the Creality fixes below. ### Fixed - Creality CFS spool colors were being read wrong, which made the dashboard's "possible wrong spool" warning show up on nearly every Creality spool and stay there for good (#79). Creality reports color as `#0rrggbb`, where the real RGB value is the last six characters rather than the first six. Every color except black was compared as a different color, so no value you could enter in Spoolman would ever match. - Creality spools are no longer matched by RFID serial, because the CFS does not report one. Its `rfid` attribute is Creality's material type code (PLA is 00001, PETG is 00003), which every spool of that material shares. Treating it as a unique serial could auto-assign whichever spool last carried that code, and could move the code from one spool to another on each print. Serial matching is now Bambu Lab only. Creality spools are matched by their tray assignment instead, which is how SpoolmanSync tracks every other brand of filament. Installs still running older automations are covered without regenerating them. ### Added - New "Ignore color in spool mismatch warnings" setting under Settings, in the Dashboard Display section. The warning then compares material only, which helps if your RFID tags report a color the physical spool does not actually have. This is common with third-party Creality tags. ## [1.6.10] - 2026-08-17 ### Security - Updated dependencies to resolve open security advisories. The main bumps are Next.js 16.1.6 to 16.3.1, ws 8.19 to 8.21.3, and the Prisma packages to 7.9.1, plus transitive patches to postcss, nanoid, sharp, and others. No app changes. Verified with the full test suite, production builds of both Docker images, and a live container smoke test. ## [1.6.9] - 2026-08-17 > Upgrade note: re-run Auto-configure / regenerate your Home Assistant automations to pick up the tracking fix below. ### Fixed - Filament usage could be silently lost when the active tray sensor blipped through its empty idle state, which happens on every tray change and on brief connection hiccups (#77). The automation no longer resets the usage meter when a tray becomes active. A blip back to the same tray keeps counting, and a switch to a different tray first deducts the accumulated usage from the previous tray. Requires regenerating automations. ### Added - Spoolman locations now follow a printer rename in Home Assistant. Renaming the device used to strand assigned spools in their old locations until each was re-assigned. The dashboard now migrates them automatically. Locations you set by hand are never touched. ## [1.6.8] - 2026-08-03 ### Fixed - Add-on release notes now appear in Home Assistant (#76). The add-on's changelog file was a placeholder linking to the GitHub Releases page (which is empty, since releases are cut as git tags), so the update dialog and the add-on page's Changelog link never showed what changed — including upgrade notes like the recent "regenerate your automations" ones. Home Assistant reads the `CHANGELOG.md` next to the add-on's `config.yaml`, never GitHub releases or tags; that file is now a symlink to this changelog, so updates display the full release history. ## [1.6.7] - 2026-07-28 > Upgrade note: re-run Auto-configure / regenerate your Home Assistant automations to pick up this fix. Without regenerating, behavior is unchanged. ### Fixed - Print-end deductions are no longer silently skipped when the printer's connection blips at print completion (follow-up to #75, reported on the forum with a Bambu X2D). Many Bambu printers briefly report `offline` for a few seconds right as a print finishes, so the stage arrives at `idle` from `offline` — a sequence the automation treated as a power-on and ignored, without logging anything. The power-on protection (#66) now rests entirely on the meter guards added in v1.6.6: the usage meter is zeroed after every flush and after a sustained two-minute offline, so a boot-time print-end fires with 0g and deducts nothing, while a genuine print end arriving via a brief offline blip now deducts normally. Two visible side effects: powering the printer on may log a harmless "SPOOLMANSYNC PRINT END (skipped)" info entry, and a quick (under two minutes) power loss mid-print now deducts the filament that was actually consumed before the outage instead of discarding it. ## [1.6.6] - 2026-07-26 > Upgrade note: existing users should re-run Auto-configure / regenerate their Home Assistant automations to pick up the filament-usage fix below. Without regenerating, behavior is unchanged (nothing breaks). ### Added - Optional "location when unassigned" holding pen. With location sync enabled, a spool removed from a tray normally has its Spoolman `location` cleared, which makes it disappear from Spoolman's location views until you remember to file it. You can now set a location — e.g. "Holding Pen" — that unassigned spools are parked in instead. The field appears under the "Sync spool locations to Spoolman" toggle and is empty by default, preserving the existing clear-on-unassign behavior; it has no effect at all unless location sync is on. A location you set by hand is still never overwritten. ### Fixed - Spoolman location suggestions are no longer stale. The pick-list offered when creating a virtual printer was derived only from locations already written on spools, and counted archived spools. As a result, locations created in Spoolman didn't appear until a spool was moved into them, and deleted locations lingered indefinitely whenever an archived spool still carried the name. SpoolmanSync now reads Spoolman's own `locations` setting first (preserving your ordering) and then adds any additional locations found on non-archived spools — the same list Spoolman's Locations page builds — so the two always agree. The Settings page also refreshes the list when the tab regains focus. - Missing Home Assistant entities no longer fail silently. When a printer-level entity such as `print_weight` couldn't be discovered, the generated configuration contained `states('')` — a template that errors on every evaluation, leaving the filament-usage sensor dead, the utility meter at zero, and no usage webhook ever sent, with the only trace a warning on the server console. SpoolmanSync now generates an explicitly unavailable sensor that names the missing entity, reports the problem in the Automations page (in every deployment mode) and the activity log, and keeps spool assignment and tray-change detection working. A missing print-stage entity no longer emits a blank trigger `entity_id` for Bambu or Creality printers, which previously made Home Assistant reject the entire automation — including the tray-change tracking that was otherwise unaffected. A printer discovered with no trays or external spools at all is now skipped rather than emitting an automation with an empty trigger list that would fail to load alongside every other printer in the same file. - Spool serial (RFID / `tray_uuid`) auto-matching is no longer defeated by formatting. Matching required an exact match on the raw stored value, so a serial entered by hand in Spoolman — stored bare rather than JSON-encoded, or differing only in case or whitespace — never matched, and the resulting log entry claimed no matching spool existed. Comparison is now normalized on both sides, without coercing numeric-looking serials. - The tray-change log entry no longer claims "no matching spool" when a spool is assigned. That check only ever looked up the tray's RFID serial, never the tray assignment, so it fired for any correctly-assigned spool that hadn't yet completed a tracked print — appearing to contradict the dashboard. The entry now states what was actually checked and records whether a spool remains assigned. - Fixed two false positives in the dashboard's "possible wrong spool" warning: a Spoolman colour stored with a leading `#` was compared against a stripped RFID colour and always flagged, and material variants such as `PLA+` and `PLA_Basic` were flagged against the printer's `PLA`. Genuinely different materials, including compound ones such as `PLA-CF`, are still flagged. - Filament usage is no longer under-counted when the printer's connection flickers mid-print (#75). The automation reset the usage meter every time the printer's stage touched `offline`, even for a seconds-long MQTT blip (common with a Panda Touch or other second client competing for the printer's connection slots). A print's deduction then covered only the filament used after the last blip — e.g. 17.7g logged for a 174.8g print. The meter is now only reset after the printer has been offline for a sustained period (2 minutes), so real power-offs still clear it (the protection added for #66) while brief flickers no longer destroy tracked usage. Also hardens the usage sensor's availability so a progress-sensor flicker cannot over-count. Requires regenerating automations to take effect. - Add-on auto-configure no longer breaks setups that already use Home Assistant packages (#73). The detection of an existing `packages:` entry in configuration.yaml failed on CRLF line endings (files edited on Windows over Samba), on a UTF-8 BOM, and on quoted paths or trailing comments — SpoolmanSync then inserted a second `packages:` key under `homeassistant:`. YAML keeps the last duplicate key, so the SpoolmanSync package was silently never loaded while everything reported success, and automations failed at runtime with "Action rest_command.spoolmansync_tray_change not found". Detection now handles all of these forms, auto-configure refuses with a clear error instead of ever inserting a duplicate, and it automatically repairs the duplicate-key state left behind by earlier versions (only ever removing the exact line SpoolmanSync itself inserted). - Connection failures during Home Assistant OAuth are no longer misreported as "OAuth authentication failed" when the real problem is that the SpoolmanSync container cannot reach Home Assistant at all (#74). Connecting now runs a quick reachability check before sending you to the Home Assistant login, and a network-level failure during token exchange is reported as exactly that, with a hint to check Docker networking. ### Changed - External-mode setup instructions now require a full Home Assistant restart instead of offering "or reload automations". Reloading automations does not create the `input_number`, `utility_meter`, `template` and `rest_command` entries, which left tray-change detection working while filament usage was never deducted. ## [1.6.5] - 2026-07-11 ### Added - Optional two-way sync between spool locations and Spoolman's native `location` field (opt-in; off by default). Enable "Sync spool locations to Spoolman" in Settings and: - Assigning a spool to a real AMS/CFS tray sets its Spoolman location to `" - Tray "` (or `" - External"`), and assigning to a virtual printer (dry box/shelf) sets it to the virtual printer's name — so Spoolman reporting shows where every spool is, whether loaded in a printer or in storage. - When creating a virtual printer, existing Spoolman locations are offered as a pick-list so names line up with the native location field. - Unassigning a spool clears the location, but only when it still matches the label SpoolmanSync set — a location you set by hand is never overwritten. The feature is a no-op (and safe) when Home Assistant is unreachable, and only affects spools as they are assigned or unassigned. ## [1.6.4] - 2026-07-11 > Upgrade note: existing users should re-run Auto-configure / regenerate their Home Assistant automations so tray-change webhooks include the current print state. Without regenerating, the fix below stays inactive (behavior is unchanged, nothing breaks). ### Fixed - Filament usage is no longer lost during an AMS runout / auto-refill mid-print (#71). When a tray ran empty while a print was still active, the ran-out spool could be auto-unassigned before its accumulated usage was flushed, so the deduction was dropped and only the replacement spool was charged. Tray-change events during an active print are now treated as possible runout transitions and the assignment is preserved, so the subsequent usage flush still matches and deducts from the correct spool. Empty-tray auto-clear continues to work as before when the printer is idle, finished, or offline. ## [1.6.3] - 2026-06-25 > Upgrade note (embedded mode): pull the latest images and recreate the containers, e.g. `docker compose pull && docker compose --profile embedded up -d`. On startup the bundled Home Assistant then refreshes ha-bambulab to the version shipped in the image. ### Fixed - Embedded mode now keeps its bundled Home Assistant integrations up to date. Previously the bundled ha-bambulab was copied into the HA config only on first run and never refreshed, so existing embedded users stayed on an old version. The container now updates the bundled ha-bambulab (and ha_creality_ws) on startup whenever the image ships a newer version, without downgrading a newer copy or touching HACS-managed integrations. This delivers upstream ha-bambulab fixes, including the duplicate-AMS-device bug behind reports of phantom AMS HT units (#70). ## [1.6.2] - 2026-06-23 > Upgrade note: existing virtual-printer assignments migrate automatically the first time the dashboard or Settings page loads after updating — no manual steps required. ### Fixed - Virtual-printer spool assignments now use a readable key in Spoolman — `virtual__tray_`, matching the real-AMS key style — instead of the opaque `virtual::` (#70). Existing assignments are migrated automatically. Renaming a virtual printer re-keys its assignments so none are lost, and virtual-printer names are now required to be unique. ## [1.6.1] - 2026-06-19 > Upgrade note: re-run **Auto-configure** (regenerate and re-apply the automations) and restart Home Assistant to pick up the updated tray trigger. ### Fixed - Filament usage could be badly under-counted when the printer or MQTT connection briefly flickered mid-print (#69). A transient `unavailable` blip on the active-tray sensor was treated as a tray change by the Update Spool automation, which reset the usage meter and discarded the filament tracked so far (e.g. 2.3 g logged for a 25.6 g print). The tray trigger now ignores `unavailable`/`unknown` transitions on both Bambu and Creality printers. ## [1.6.0] - 2026-06-19 > Upgrade note: to apply the power-on and tray-clear fixes (#66, #65) and enable webhook authentication, re-run **Auto-configure** (regenerate and re-apply the automations) and restart Home Assistant. The other changes take effect on update alone. ### Added - **Virtual printers** for dry boxes, filament dryers, and shelves (#67). Create them in Settings with assignable slots; they appear on the dashboard and support QR/NFC assignment like real trays, but are excluded from usage tracking. Deleting a printer or slot clears any spool assigned to it. - **Single-spool / non-AMS printer support** (#68). Printers without an AMS/CFS (e.g. Ender 3 V3 KE) now get an assignable external-spool slot so their filament can be tracked. - **Edit or delete usage events** from the Logs page to correct statistics (#54). By default this only adjusts SpoolmanSync's statistics; an opt-in option also adjusts the spool's remaining weight in Spoolman. - **Webhook authentication**: the Home Assistant webhook can require a generated shared-secret token, injected into the automations, preventing unauthenticated inventory changes from other devices on the network. - **"Never auto-clear tray assignments"** setting for setups with flaky AMS reporting (#65). - Unit test suite (Vitest) covering the filament-tracking logic. ### Fixed - Filament usage is no longer deducted a second time when a printer is powered back on (#66). The print-completion automation now ignores the printer's offline state, and the usage meter resets when the printer goes offline. - Spool assignments are no longer cleared when the AMS briefly reports a tray as empty/unavailable during a reconnect (#65). The webhook ignores transient states and re-checks the live tray state before unassigning. - Usage-by-spool report no longer shows the same used weight for different spools that share a vendor and color (#64). Spool labels now include the Spoolman id to distinguish identical filaments. - The "Print Jobs" statistic counted every deduction event rather than prints; it is relabeled "Usage Events" to match the underlying data (#54). - Live updates now fall back to polling if the event stream drops after connecting; plus assorted resource-leak, race-condition, and component-lifecycle fixes. - Home Assistant token refresh now persists rotated refresh tokens and refreshes shortly before expiry. - The Home Assistant admin password is no longer returned by the settings API on every load; it is revealed only on explicit request. ## [1.5.3] - 2026-04-19 ### Fixed - Dashboard now shows user-renamed printer names from Home Assistant instead of the integration-provided serial number. This was a regression from the WebSocket API migration. ## [1.5.2] - 2026-04-18 ### Fixed - Ingress port conflict with other add-ons when using host networking (#63). The add-on now uses dynamic port assignment from HA Supervisor instead of hardcoded port 8099. ## [1.5.1] - 2026-04-12 ### Fixed - Add-on mode configuration no longer conflicts with users who split their HA config using `!include` directives (#61). SpoolmanSync now writes to an isolated HA package file instead of appending to `configuration.yaml`. - Configuration.yaml is backed up before modifications and validated via HA's check_config API, with automatic revert on failure. ## [1.5.0] - 2026-04-10 ### Added - **Creality printer support** via the [ha_creality_ws](https://github.com/3dg1luk43/ha_creality_ws) integration (#28). Supports K1, K2, K2 Plus, Hi, Ender 3 V3 and other Creality printers with CFS (Creality Filament System). Bambu Lab and Creality printers can be managed side-by-side on the same dashboard. - Brand selection in the Add Printer dialog (Bambu Lab or Creality) - Automatic filament weight calculation for Creality printers, converting reported length (cm) to weight (g) using material-specific density lookup (PLA, PETG, ABS, ASA, TPU, PC, Nylon, etc.) - ha_creality_ws integration pre-installed in the embedded Home Assistant Docker image - Better error messages when a printer integration is not installed in Home Assistant ### Changed - Documentation streamlined and updated to reflect multi-brand support ## [1.4.3] - 2026-04-07 ### Fixed - Archived spools showing as "Unknown Spool" in usage reports (#58) - Unassigned tray warnings not differentiating between AMS units on multi-printer/multi-AMS setups (#59) ### Added - Optional spool location display on dashboard cards, enabled via Settings (#56) ## [1.4.2] - 2026-03-24 ### Fixed - AMS units merging together on multi-AMS setups where the model name (e.g., "AMS 2 Pro") was confused with the AMS unit number (#53) ### Added - Configurable QR code / NFC base URL in Settings for users behind reverse proxies or custom domains (#52) - Numbered display names for multiple AMS HT units (AMS HT, AMS HT 2, etc.) ## [1.4.1] - 2026-03-23 ### Fixed - AMS tray detection with ha-bambulab v2.2.21 which changed tray sensor `translation_key` from per-tray values (`tray_1`, `tray_2`) to a shared `tray` key with placeholders (#51) ## [1.4.0] - 2026-03-22 ### Changed - Entity discovery now uses HA's WebSocket API with translation_key matching instead of regex-based entity name patterns, making discovery stable across entity renames and HA language changes (#50) - Spool-to-tray assignments are now stored by unique_id (stable) instead of entity_id (can change if renamed) - External mode automation registration now uses per-printer format matching embedded/addon mode, enabling stale automation detection for all deployment modes ### Added - Dashboard warning banner when HA entity IDs have changed since automations were last configured - Fallback matching for pre-migration spools that still use entity_id-based assignments ### Fixed - Jinja2 null guard for `trigger.from_state`/`trigger.to_state` in generated automations, preventing errors on HA restart ### Removed - `entity-patterns.ts` and associated tests (replaced by WebSocket-based discovery) ## [1.3.6] - 2026-03-16 ### Fixed - Tray material mismatch warnings no longer trigger for filament variants of the same base material (e.g., "PLA Matte" assigned to a tray reporting "PLA") (#49) ## [1.3.5] - 2026-03-15 ### Fixed - AMS discovery for user-renamed AMS devices with custom names (e.g., `ams_links_`, `ams_rechts_`, `ams_left_`, `ams_right_`) now works via device-based fallback (#47) ## [1.3.4] - 2026-03-14 ### Fixed - AMS entity detection for H2D printers using compact naming format (e.g., `sensor.h2d_ams2_1_humidity`, `sensor.h2d_amsht_1_humidity`) (#45, #47) - External spool detection for H2D printers using underscore+digit naming (e.g., `sensor.h2d_externalspool_1_external_spool`) (#45, #47) ## [1.3.3] - 2026-03-08 ### Fixed - AMS HT entity detection for H2C printers using compact naming format (e.g., `sensor.h2c_ht1_humidity` instead of `sensor.h2c_ams_ht_1_humidity`) (#35) ## [1.3.2] - 2026-03-08 ### Added - **Multi-external spool support** - Printers with multiple external spools (e.g., Bambu H2C) are now fully supported across discovery, dashboard, spool assignment, and automation config generation (#35) ### Fixed - Active tray detection for external spools now uses the `active` attribute directly from ha-bambulab instead of inferring activity from AMS tray state, enabling accurate detection on multi-nozzle printers (#35) - AMS HT entity detection improved with proper composite ID encoding and display name handling (#35) - Usage report chart no longer shows gaps when days have zero usage; x-axis is now continuous ## [1.3.1] - 2026-03-01 ### Added - **Low filament stock alerts** — Get notified via Home Assistant persistent notifications when you're down to your last spool of a filament type and it's running low. Configurable thresholds (percentage or grams), grouping strategies (material, material+name, material+name+vendor), and selective group monitoring (#23) ### Fixed - Printers with versioned ha-bambulab entities (e.g., `print_status` and `print_status_2`) no longer appear as duplicates on the dashboard (#35) - External spool not detected for ha-bambulab versions using underscore hybrid entity names (e.g., `external_spool_externe_spoel`) — added support for all languages (#38) ## [1.3.0] - 2026-02-27 ### Added - **Filament usage reporting dashboard** — New Reports page with summary cards, per-spool bar chart with filament color fills, stacked area chart for usage over time, and detail table. Filter by time period (7d, 30d, 90d, 1y, all) with automatic daily/weekly bucketing (#22) - **Kiosk mode** — Touch-optimized interface at `/kiosk` for small screens with USB NFC/RFID readers (e.g., Raspberry Pi kiosk setups). Cookie-based opt-in, zero impact on normal users (#29) - **App version display** — Version number shown in footer on all pages (#30) ### Fixed - Null vendor on filaments no longer crashes the dashboard (#31) - Number input fields in QR label settings no longer clamp values on every keystroke, allowing multi-digit entry (#32) - Stacked area chart in usage report uses linear interpolation to prevent visual crossing artifacts ## [1.2.4] - 2026-02-22 ### Fixed - No longer store or auto-match against all-zero spool serial numbers from non-Bambu spools (#15) ## [1.2.3] - 2026-02-22 ### Fixed - Internal Next.js port (3001) no longer hardcoded in add-on mode — now derived dynamically from the configured direct access port to avoid conflicts on host_network (#27) ## [1.2.2] - 2026-02-22 ### Added - **AMS filament info in unassigned tray banner** — the "Assign Spools to Trays" alert now shows the material, name, and color reported by the AMS for each unassigned tray, making it easier to find the matching Spoolman spool (#15) ### Fixed - Generated REST command webhook URL in add-on mode now uses the configured port instead of hardcoded 3000 (#26) ## [1.2.1] - 2026-02-17 ### Added - **"Remaining" weight badge** on dashboard tray slots showing filament remaining - **Multi-color filament display** across all spool color swatches (dashboard, tray dialog, scan pages) - **Expand/collapse toggle** for spool list in the QR label generator ### Fixed - Remove printer button no longer deletes the printer from ha-bambulab — now only removes it from SpoolmanSync with the ability to re-add (#25) - "Go to Settings" button on automations page navigated to a 404 in add-on mode (ingress path issue) - Dashboard, automations discovery, and auto-configure now correctly filter out printers removed from SpoolmanSync - HA restart after automation configuration in add-on mode now prompts user instead of restarting without warning - Responsive UI improvements for logs filter buttons, tray "Remaining" badge, and label sheet print settings on small screens ## [1.2.0] - 2026-02-17 ### Added - **Multi-printer automation support** — Configure Automations now generates per-printer automations, helpers, and template sensors for all discovered printers instead of only the first (#20) - **Spool sorting** — Sort by ID, Name, Material, or Vendor in the QR label generator, NFC writer, and tray assignment dialog - **QR label sheet persistence** — Label sheet settings and printed-spool tracking are saved to localStorage across sessions - **AMS Pro type-first entity naming** — Support for Danish and other locales where ha-bambulab produces entity IDs like `ams_pro_2_bakke_1` (#18) ### Fixed - `utility_meter.calibrate` unknown action error — `cycle: none` is not a valid HA utility_meter value; omit the key entirely for no-cycle behavior (#19, #21) - Responsive UI issues on logs page and tray assignment dialog on mobile ### Changed - Helper entity names now include the printer prefix (e.g., `input_number.spoolmansync_{prefix}_last_tray`). **Existing users must click "Reconfigure Automations" once** after updating. Old singleton entities will become orphaned and can be manually deleted from the HA entity registry. ## [1.1.2] - 2026-02-16 ### Added - **Multi-spool label sheet printing** — Select multiple spools and print QR labels on standard label sheets (e.g., Avery 8160). Configurable paper size, grid layout, margins, spacing, borders, and label content ### Fixed - Incorrect filament usage for long prints crossing Monday midnight — utility meter was configured with `cycle: weekly`, causing HA to reset accumulated weight automatically (#19) - False RFID mismatch warnings on non-Bambu (third-party) spools without RFID tags (#15) ## [1.1.1] - 2026-02-14 ### Added - Configurable direct access port for the HA add-on — change in the add-on Configuration tab to avoid port 3000 conflicts with other add-ons (#14) ### Fixed - QR code and NFC tag URLs now use the configured port instead of hardcoded 3000 - Removed confusing duplicate Network port section from add-on Configuration UI ## [1.1.0] - 2026-02-13 ### Added - **Home Assistant add-on** - Install directly from the HA add-on store with ingress sidebar integration; auto-discovers printers from ha-bambulab - **QR code label generation** - Create and print QR code labels for spools; scan with phone camera to assign to AMS trays - **NFC tag writing** - Write spool URLs to NFC sticker tags for tap-to-assign on Android devices - **Dynamic spool assignment page** - QR scans and NFC taps redirect to a dedicated assignment page with tray selection - **AMS 2 Pro and AMS HT support** - Entity pattern matching for newer AMS hardware variants - **Auto-recovery for broken HA connections** - Embedded mode silently re-authenticates when tokens are invalidated; shows reconnect form if password was changed (#10) - **Unraid Community Apps template** - XML template and icon for Unraid CA store ### Fixed - External spool active tray detection for printers without AMS (#11) - Crash when assigned spool has missing filament color or material data (#12) - AMS discovery for entities with renamed or missing printer prefix ## [1.0.0] - 2026-02-09 ### Added - **Dashboard** - View all printers, AMS units, and tray assignments at a glance - **Spool assignment** - Click any tray to assign a spool from Spoolman inventory - **QR/barcode scanning** - Scan Spoolman QR codes to quickly look up and assign spools - **Automatic filament usage tracking** - Deduct used filament weight after prints - **Multi-AMS support** - Track multiple AMS units per printer - **A1 AMS Lite support** - Works with Bambu A1/A1 Mini - **External spool support** - Track filament loaded outside the AMS - **Bundled Home Assistant** - Embedded mode includes pre-configured HA with HACS and ha-bambulab - **Bambu Cloud login** - Add printers using Bambu Cloud credentials - **17 language support** - Works with all ha-bambulab localizations - **Multi-architecture Docker builds** - Supports amd64 and arm64