Spool Studio v3.0.8

Spool Studio v3.0.8

Changes

• Added a Link scanned UID workflow for Paxx12 SpoolLink setups.
• Empty or non-OpenSpool NFC tags now keep their physical NFC UID after reading, so that UID can be assigned to an existing Spoolman spool.
• Writing a selected Spoolman spool to RFID now keeps the selected spool as the source and links the written tag UID back to that Spoolman record.
• UID assignment uses Spoolman extra.card_uids and removes the same UID from other spools before assigning it to the selected spool.

Workflow

1. Select an existing spool from Spoolman.
2. Read the physical RFID/NFC tag to capture its UID.
3. Use Link scanned UID to store that UID on the selected Spoolman spool without changing tag content, or use Write RFID to write the selected spool data and link the UID in one step.

Notes

• Built for the Paxx12 SpoolLink workflow where the printer identifies spools by the physical tag UID stored in Spoolman.
• This fixes the case where a selected Spoolman spool without UID could accidentally continue as a new spool workflow after reading or writing a fresh tag.

Spool Studio v3.0.7

Spool Studio v3.0.7

This update adds support for Spoolman instances protected by HTTP Basic Authentication and restores the full manual toolhead assignment workflow.

Changes

• Spoolman URLs can now include Basic Auth credentials, for example https://username:password@spoolman.example.com.
• The credentials are converted into an Authorization: Basic ... header for all Spoolman API calls.
• The Retrofit base URL is sanitized internally so credentials are not passed as URL user-info to every request.
• Manual Toolhead Status assignment now shows all Spoolman spools again.
• Spools without UID data are still assignable and marked with No UID stored.
• Spools that still need v3 field conversion are still assignable and marked with Needs v3 conversion.

Notes

Manual toolhead assignment remains a temporary override. If the printer later reads an RFID tag whose UID points to a different Spoolman spool, the firmware may replace the manually assigned spool again.

Spool Studio v3.0.6

Spool Studio v3.0.6

This update improves the Paxx12 SpoolLink readiness flow and the Settings screen behavior.

Changes

• Toolhead Status can now show live printer-reported filament data even when the firmware reports no Spoolman spool ID yet.
• The Spoolman info panel is refreshed immediately after a successful Spoolman connection test.
• The Spoolman URL and Moonraker URL fields keep focus when using left/right cursor keys.
• Version metadata and README version text updated to 3.0.6.

Notes

If a filament is shown on the printer without Spool ID or remaining weight, the printer is seeing filament data but has not matched the physical NFC tag UID to a Spoolman spool yet. Select the Spoolman spool in Spool Studio and write the RFID tag again so the tag UID is stored on that existing Spoolman record.

Spool Studio v3.0.5

Changes

• Added Connection Profiles in Settings.
  • Existing Spoolman and Moonraker URLs are migrated automatically into a first Default profile.
  • Profiles store Spoolman URL and Moonraker URL together.
  • The active profile can be selected from a dropdown.
  • Profiles can be created, renamed and deleted directly in Settings.
• The existing URL fields now always edit the currently selected profile.
• Saving Settings activates the selected profile and reloads Spoolman / Moonraker data.

Notes

• No automatic server detection is included; profile selection is manual by design.
• Existing display, Spoolman, RFID and paxx12 SpoolLink behavior is unchanged.

Spool Studio v3.0.4

Changes

• Added an RGB display below the HEX color field.
  • The RGB value is generated from the selected HEX color.
  • The value can be copied directly from the app.
• Added an Archive selected spool action next to Delete selected spool.
  • Archiving marks the selected spool as archived in Spoolman.
  • RFID tags are not changed by the archive action.
  • The app reloads the Spoolman list after a successful archive.

Notes

• Archiving requires a configured and reachable Spoolman connection.
• The archive action uses a confirmation dialog, matching the existing delete workflow.

Spool Studio v3.0.3

Spool Studio v3.0.3

This update tightens the Paxx12 SpoolLink workflow and fixes the remaining edge cases around tag writing and manual toolhead assignment.

Changes

• Improved Paxx12 toolhead assignment compatibility.
• The app now checks for an available printer assignment command and supports the current SET_SPOOL_ID path as well as newer assignment command variants.
• Fixed the Settings readiness display so the assignment command is shown as a clear Loaded / Missing status instead of a long command name that wraps awkwardly.
• When writing an RFID tag for an already selected Spoolman spool, the app now links the physical tag UID back to that existing Spoolman record instead of treating it like a new spool.
• Printer readiness checks are refreshed automatically after startup/settings changes when a Moonraker URL is configured.

Notes

For current Paxx12 firmware builds, manual toolhead assignment still depends on the assignment command exposed by the printer firmware. If assignment is reported as missing, check the printer Spoolman integration settings and restart Klipper/Moonraker.

Spool Studio v3.0.2

Spool Studio v3.0.2

Spool Studio v3.0.2 is the first non-beta v3 release for the new paxx12 SpoolLink workflow.

It was tested with paxx12 Extended Firmware v1.5.2-paxx12-21.

This release is intended for the new paxx12 firmware logic where RFID/NFC tags are linked to Spoolman spools by the physical tag UID. Older Spool Studio v2 tags can still be read and converted, but v3 writes only the new paxx12-compatible format.

Important migration note

Spool Studio v3 is not just a visual update. The tag and Spoolman linking logic changed.

Old v2 workflow:

• tags were linked mainly through the old spool-id based data
• the app could work with older paxx12 firmware versions
• material names such as PLA+ were handled by writing printer-safe values to the tag

New v3 / paxx12 workflow:

• the physical NFC tag UID is the important identifier
• the UID is stored in Spoolman under extra.card_uids
• the printer firmware can resolve the spool from Spoolman by reading the tag UID
• Spool Studio writes only the new paxx12-compatible tag format

If you still need the old workflow, please stay on the latest v2 release.

Recommended migration workflow

1. Install a compatible paxx12 firmware version, tested with v1.5.2-paxx12-21.
2. Enable the Spoolman integration in the printer firmware.
3. Open Spool Studio Settings.
4. Test the Spoolman connection.
5. Test the Moonraker connection and open Show Moonraker Info.
6. Make sure the required assignment command SET_SPOOL_ID is reported as available.
7. Read one existing v2 tag first.
8. Let Spool Studio convert only this one spool first.
9. Write the tag again with Spool Studio v3.
10. Check the result in Spoolman, Spool Studio and the printer / Fluidd UI.
11. Continue with the remaining spools after the first test is correct.

Required printer command check

Spool Studio checks whether the required paxx12 G-code command is available:

SET_SPOOL_ID

This command was only available after enabling:

AFC Lite via Fluidd/Mainsail

on the paxx12 firmware configuration page and restarting the printer services.

If SET_SPOOL_ID is missing, Spool Studio shows this in:

Settings -> Show Moonraker Info

This is important because manual toolhead assignment from the app depends on that command.

UID based tag workflow

The new workflow no longer uses the old tag content as the primary link to a spool.

Instead, the physical UID of the RFID/NFC tag is used.

Workflow:

1. Spool Studio reads the physical UID from the tag.
2. The UID is stored in the Spoolman spool record under extra.card_uids.
3. When the printer reads the tag, the paxx12 firmware can look up the matching spool in Spoolman using this UID.
4. The spool data then comes from Spoolman, while the tag acts as the physical identifier.

In short: reading an old tag and writing it again with Spool Studio v3 stores the tag UID in Spoolman and updates the tag to the new paxx12-compatible format.

If a spool has no UID yet, read the tag and write it again with Spool Studio v3. This stores the physical tag UID in Spoolman and makes the spool fully compatible with the new UID-based workflow.

Why the Material Modifier field exists

I wanted to keep information such as the + in PLA+, while still staying compatible with the new paxx12 firmware logic.

The firmware expects printer-safe material values such as PLA, PETG, ABS, etc. A value like PLA+ can cause problems because it is not a valid printer material in this workflow.

There is also a second problem: paxx12 separates the filament data into fields such as material and variant. That works well for simple cases like:

• Material: PLA
• Variant: Matte

But a filament such as PLA+ Matte contains two pieces of information:

• Plus as a material modifier
• Matte as the visual / filament variant

Putting both into the regular variant field would turn it into Plus Matte and mix two meanings into one paxx12 / Spoolman field. Putting PLA+ into the material field would keep the label, but it would no longer be a printer-safe material value.

To avoid losing that information, Spool Studio now supports an optional Spoolman filament extra field:

material_modifier

Example conversion:

PLA+ - Silk

becomes:

• Material: PLA
• Material modifier: Plus
• Variant: Silk

This keeps the printer-compatible material clean, while Spool Studio can still display and preserve the full meaning of the filament.

Spool Studio can create the required material_modifier field in Spoolman after confirmation. If the user declines this, the app can still be used, but the material modifier field is disabled and additional information such as Plus or HS cannot be preserved separately.

The field setup can be checked later in:

Settings -> Show Spoolman Info

This was intentionally implemented as an extra field instead of overloading the official paxx12 fields. The goal is to stay compatible with the firmware and still keep the information that is useful for the app and for the user.

Converting old v2 tags

When an old Spool Studio v2 tag is read, Spool Studio v3 can detect the old format and offer a conversion.

The conversion can:

• read the old tag data
• identify the matching Spoolman spool
• store the physical tag UID in extra.card_uids
• convert old material strings into the new structure
• preserve modifiers such as Plus
• write the new paxx12-compatible tag format

If conversion is declined, Spool Studio v3 will not write legacy data. In that case, use Spool Studio v2 for the old workflow.

Converting existing Spoolman data

There is also a Settings tool to scan existing Spoolman filament records and choose which records should be converted. This is intentionally selectable, so test records or special cases do not need to be changed automatically.

The Spoolman legacy conversion tool can be found here:

Settings -> Show Spoolman Info -> Scan legacy Spoolman materials

Spool Studio scans existing Spoolman filament records and shows a selectable list. You can choose which records should be converted to the new v3 / paxx12-compatible structure.

The conversion keeps existing spools, UID assignments and product / lot codes. It only patches the selected filament records.

Manual toolhead assignment

Manual toolhead spool assignment is available again in the Toolhead Status dialog.

The assignment uses the paxx12 / Moonraker path and requires SET_SPOOL_ID to be available.

Important behavior:

• Manual assignments can work even when a spool has no stored UID yet.
• Spools without a stored tag UID are marked with No UID stored.
• These manual assignments can be replaced by the firmware when it reads an RFID tag and resolves the spool through UID-based Spoolman lookup.
• For a fully stable UID workflow, read and rewrite the tag with Spool Studio v3 so the UID is stored in Spoolman.

The manual Assign spool dialog only shows spools that already use the new paxx12-compatible Spoolman field layout. Spools without a UID are still selectable, but clearly marked.

Toolhead Status: App labels and SpoolLink

The Toolhead Status dialog has two display modes:

• App labels
• SpoolLink

App labels shows the filament names as Spool Studio builds them for the app UI. This includes additional information such as the optional Material modifier, for example showing PLA+ / Silk even though the printer-safe material is stored as PLA.

SpoolLink shows the data as reported by the paxx12 Spoolman / SpoolLink integration. This is useful for checking what the printer firmware currently sees and receives from its Spoolman integration.

In short:

• App labels = Spool Studio view with preserved app-side labels and modifiers
• SpoolLink = printer / firmware reported view

This helps compare whether the app-side data and the printer-side SpoolLink data match as expected.

This is especially useful while migrating:

• If App labels still show the expected label, Spool Studio can still reconstruct the user-facing filament name.
• If SpoolLink shows different data, the difference comes from what the firmware currently reports.
• This makes it easier to tell whether a mismatch is in the app data, Spoolman, or the printer firmware / Fluidd integration.

The edit icon in the Toolhead Status dialog opens the manual spool assignment. This is useful when a spool is loaded without a readable RFID tag or when a toolhead needs to be assigned manually. The assignment can still be replaced later when the printer reads an RFID tag and resolves the spool through the UID-based Spoolman workflow.

Settings info buttons

The Settings screen contains two diagnostic info sections.

Show Spoolman Info checks and displays Spoolman-side readiness:

• Spoolman reachability
• required Spoolman extra fields
• card_uids support for UID-based tag linking
• material_modifier support for preserving values such as Plus or HS
• access to the legacy Spoolman material conversion tool

Show Moonraker Info checks and displays printer / firmware readiness:

• printer firmware version
• Moonraker availability
• Spoolman service status reported by the printer
• RFID bridge status
• availability of the required SET_SPOOL_ID assignment command

The app uses these checks to warn before tag writing or manual assignment if the setup is incomplete.

Other changes

• Version updated to 3.0.2.
• Beta label removed.
• Settings screen updated to match the Spool Studio v3 design.
• Main dropdown dialogs were restyled.
• Brand, color, color wheel, photo detection and empty spool weight dialogs were aligned with the new dark dialog style.
• Spool selection dialogs now show spool artwork and clearer metadata.
• The Select from Spoolman dropdown now includes the spool ID in the list while keeping the selected value clean.
• Toolhead status dialog was redesigned and now supports manual assignment again.
• Success messages were shortened where the...

Spool Studio v3.0.1 Beta

Spool Studio v3.0.1 Beta

This is a beta / test release for the Paxx12 SpoolLink workflow. It is intended for testing with current Paxx12 1.5.x beta firmware and Spoolman integration. The latest stable release for the older workflow remains v2.0.4.

Tested with Paxx12 Extended Firmware v1.5.2-paxx12-21 beta / PR #567 during development. Because the firmware and web UI are still changing, differences between Spool Studio, Fluidd / firmware UI, and the Spoolman web interface may still exist.

Changes since v3.0.0 beta

• Restored manual toolhead spool assignment for the SpoolLink toolhead status view.
• Added a dark styled spool assignment dialog with searchable spool selection.
• Added material information to spool assignment dropdown entries.
• Added spool IDs to spool dropdown list entries while keeping the selected value clean.
• Improved toolhead status card layout and edit affordance.
• Reduced success-message noise after manual toolhead assignment; the refreshed status is now the main feedback.
• Improved Paxx12 SpoolLink / Moonraker assignment command handling and verification.

Important notes

• v3 writes only the new Paxx12 SpoolLink compatible tag format.
• Old Spool Studio / spool-id based tags can be detected and converted after confirmation.
• Manual toolhead assignments can be replaced by the firmware when an RFID tag is read for that toolhead.
• Please test with one spool first before converting a larger spool collection.

Recommended test flow

1. Update the Paxx12 firmware to a compatible 1.5.x beta build.
2. Enable Spoolman integration in the printer firmware.
3. Test Spoolman and Moonraker / firmware readiness in Spool Studio settings.
4. Read one existing tag.
5. Convert or write one tag.
6. Check the result in Spoolman, Spool Studio, and the printer / Fluidd UI.
7. Continue with additional spools only after the first test is correct.

Spool Studio v3.0.0 Beta

Spool Studio v3.0.0 Beta

This is the first beta release of Spool Studio v3. It introduces the new Paxx12 SpoolLink workflow and is intended for testing with the current Paxx12 1.5.x firmware generation.

Tested with Paxx12 Extended Firmware v1.5.2-paxx12-21 beta, based on PR #567.

Important

Spool Studio v3 no longer writes legacy Spool Studio / spool-id based tags.

The app now uses the physical NFC tag UID as the primary link between a tag and a Spoolman spool. The UID is stored in Spoolman and written/managed according to the new Paxx12 SpoolLink logic.

If you still use the older Paxx12 firmware or the old tag workflow, please stay on Spool Studio v2.x.

Main Changes

Paxx12 SpoolLink support

• Added support for the new Paxx12 SpoolLink based workflow.
• NFC tags are now linked to Spoolman spools using the physical tag UID.
• Spoolman compatibility checks were added for the required integration fields.
• The app can detect whether the printer and Spoolman are ready for the new workflow.
• Settings now include checks for printer reachability, firmware support and Spoolman field support.

Tag conversion

• Old Spool Studio tags can be detected when they are read.
• If an old tag is found, the app offers a conversion to the new Paxx12 SpoolLink format.
• During conversion, the app updates the matching Spoolman spool and stores the NFC card UID.
• If conversion is declined, the app keeps the new v3 workflow strict and does not write legacy data.

Material and variant handling

• Material, material modifier and variant are now handled separately.
• Values such as PLA+ are normalized for Paxx12 compatibility.
• The base material remains compatible with firmware expectations.
• Additional material information such as Plus/HS can be stored separately through Spoolman extra fields.
• Dropdown and display labels were adjusted so the app can still show user-friendly material names.

Spoolman integration

• Added support for card UID storage in Spoolman.
• Added support for material modifier storage in Spoolman.
• Added checks and guided setup for required Spoolman extra fields.
• Improved Spoolman save/update logic for the new data model.
• Improved handling of empty spool weight and manufacturer-related values.
• Spoolman dropdown entries now include the spool ID in the selection list.

NFC / RFID

• Updated OpenSpool tag writing for the new Paxx12-compatible data model.
• Improved old-tag detection and conversion flow.
• Improved Bambu Lab RFID import so parsed data is correctly applied to the spool form.
• Status messages were shortened and made more consistent.

Toolhead status

• The former Printer Mapping workflow was changed into a read-only Toolhead Status view.
• The dialog now shows the spool data reported by the printer.
• App-composed labels and SpoolLink-reported data can be compared.
• Toolhead cards now show material, variant and color information more clearly.

User Interface

• Major v3 UI redesign with a darker modern layout.
• New main screen structure with spool preview, status panel and compact data sections.
• Updated Settings screen for the new Paxx12/SpoolLink checks.
• Improved dialogs, dropdowns and status messages.
• Improved handling of low remaining filament warnings.
• Updated splash/about screen for Spool Studio v3.

Tested

• Android Studio debug build
• Unit tests
• Signed release APK created manually
• Basic app workflow tested on device
• Spoolman connection
• Paxx12 firmware integration checks with v1.5.2-paxx12-21 beta / PR #567
• NFC read/write workflow
• Toolhead status display

Known Notes

This is a beta release. Please test carefully before converting all existing tags.

Recommended workflow:

1. Install Spool Studio v3 beta.
2. Check Spoolman and printer integration in Settings.
3. Read one existing tag.
4. Convert only one spool first.
5. Verify the result in Spoolman and the Paxx12 Filament Manager.
6. Continue converting the remaining spools after a successful test.

Spool Studio v2.0.4

What's changed

• Added material information to Printer Mapping spool labels.
• Mapping selections now show ID, brand, color/name, and material for clearer toolhead assignments.
• Updated app version to 2.0.4.