Notice
Warning: While installing custom firmware does not automatically void the product warranty, any damage caused by or attributable to the installation or use of custom firmware is not covered under warranty. Use at your own risk. See Snapmaker Terms of Use for details.
If you notice a problem, always reproduce it on stock firmware before contacting Snapmaker support. Despite our best efforts, bugs can occur. Only contact support if the issue also occurs on stock firmware.
Custom firmware is intended for users with appropriate technical knowledge. Ensure you understand the implications before proceeding.
WARNING about the Custom Extensions
Installing extensions via SSH, like multiACE or HelixScreen can break the firmware. Those are externally managed, and not tested by the firmware. Their stability is subject to whoever is providing extensions. There were reports of ACE* extensions to cause Klipper failed to start and for HelixScreen to cause bootloop issues. Recovery files placed on a USB drive (extended-recover.txt or full-recover.txt) are the recommended path when SSH-installed extensions break the system.
New Features and Key Changes
- SpoolLink: automatic spool detection and Spoolman integration — maps RFID card UIDs to Spoolman spools, building on earlier ideas from @joostliebregts (#173), @unlucio (#163), and paxx12's own prior attempts (#285, #364, #445) #491 (@paxx12)
- Filament Manager UI — reconciles Official/User/Spoolman/RFID filament data per channel at
/filament/, building on earlier ideas from @Lemmons (#156) and @physicsG (#402, #414, #415) #581 (@paxx12) - Firmware stabilized on
1.5.2build.13, after riding out the1.5.xline's early instability #608 (@paxx12) - Add firmware-upgrade imposter to block Snapmaker's auto-update checks #576 (@paxx12)
- Add camera resolution/framerate settings to
firmware-config#574 (@paxx12) - Fix: confirm modal unreachable on short viewports #612 (@paxx12)
- Fix:
[components] rfiddisabling the RFID reader by default #589 (@paxx12) - Fix camera flicker #575 (@djgringoboy2003 / @paxx12)
- Fix: Panda Breath now accepts stock firmware
V1.0.4#594 (@plastikman) - Fluidd (
v1.37.2), Mainsail (v2.18.2), and OctoEverywhere (v5.1.1) all bumped to their latest versions
Full changelog: #567
Firmware 1.5.2 Stabilization
This release took longer than usual to land - we deliberately waited on Snapmaker's 1.5.x line to settle before shipping it. See Snapmaker's official release notes for V1.5.0 and V1.5.2 for the full upstream changelog:
- Top Cover support: setup wizard, Vibration Compensation recalibration prompt, fan speed control from the Control page, and usage statistics under
Settings>Maintenance>Usage Statistics(requires Snapmaker OrcaV2.3.5or Snapmaker AppV2.3.5) Allow auto-refill with different colorsoption for Auto-Refill (Settings>Print Preferences)- Upload AI detection data for spaghetti/foreign-object detection to help improve accuracy
- German and Hebrew language support
- Snapmaker TPU 90A and Snapmaker PLA Silk filament type support
- Fixed false nozzle diameter mismatch warnings that could prevent prints from starting
- Fixed nozzle heating remaining on after filament loading or unloading
We advise to perform full calibration this time around, especially if you have run any of prior 1.5.x releases.
Spoolman & SpoolLink & Filament Manager
The central feature of this release: Spoolman is a handy solution to track spools available and filament usage. This release finally brings a first class support for it.
RFID card UIDs are now mapped directly to Spoolman spools via the new SpoolLink Moonraker component, and the new Filament Manager web app (served at /filament/) shows every channel reconciled across the printer's Official tag data, User-set filament, the active Spoolman spool, and the raw RFID tag. Tags stay read-only - the UID-to-spool link lives entirely in Spoolman's card_uids custom field, so it works with any RFID-detected spool regardless of tag format.
This builds on several earlier community attempts at Spoolman integration: @joostliebregts' NFC tag spool_id proposal (#173), @unlucio's Spoolman Helper usage-tracking module (#163), and own OpenSpool spool_id extension (#285) and RFID Tag ID storage ideas (#364, #445) that led to the UID-based card_uids approach shipped here. Thanks to everyone who pushed on this.
Note about incompatibility with the OpenSpool spool_id
Some community extensions added support for spool_id encoded in a OpenSpool tag. The firmware only reads the card_uids custom field stored on Spoolman - it does not support a spool_id embedded directly on an OpenSpool-formatted tag. If your tags currently carry a spool_id (from an earlier integrations), they need to be migrated to a card_uids link. This migration can be done with any of the mobile apps below: scan the tag once and it links the card's UID to the matching Spoolman spool. Please refer to mobile apps for exact workflow.
Heroes
The Heroes of this release are people that did help to build a ecosystem of apps that read and link tags for Spoolman.
Building and maintaining these apps isn't free for their authors — Apple/Google developer subscriptions, AI coding subscriptions, and general upkeep all cost real money. If one of these apps saves you time at the printer, please consider supporting its author: buy them a coffee via the links above, or buy your next Snapmaker printer through their referral link where one is listed.
| App | Author | Platform | Min. Version | Download | Support |
|---|---|---|---|---|---|
| SpoolLink (Android) | @paxx12 | Android | v0.1.0
| Releases | — |
| SpoolPainter | @ni4223 | Android | v2.1.0
| Google Play | Referral Code: ni42
|
| SpoolKid | @marko-p | iOS | current beta | TestFlight beta | |
| SpoolTagger | NiftyBits | Windows, Linux | 1.1.0-1
| Releases | |
| 3DMRP | @MKloberg | Self-hosted, Android (web) | v0.8.1
| Releases | |
| Spool Studio | @GeorgHo | Android | v3.0.0-beta
| Releases | — |
| Spoolman itself | @Donkie | — | — | Source |
See docs/spoolman.md for the full list of supported apps and what each one offers.
Have feedback on Spoolman/SpoolLink/the apps? Let us know in #617.
Screenshots
Filament Manager
Reconciles each channel across Official tag data, User-set filament, the active Spoolman spool, and the raw RFID tag:
Spoolman
SpoolKid (iOS)
SpoolPainter (Android)
Spool Studio (Android)
SpoolLink (Android)
Install
For detailed installation instructions, see the Installation Guide.
Quick steps:
- Download
.binand put on FAT32 formatted USB device - On the printer go to
Settings>About>Firmware Version>Local Update - Select
.binand confirm.
Troubleshooting
- Persistent issues after extended recovery: Place
full-recover.txton a FAT32 USB drive and insert it while the printer is running. This performs a full wipe of printer data and overlays, then rebuilds from defaults on the next boot. Note: extensions installed over SSH (such as HelixScreen) live outside the managed overlay and may not be removed by recovery — reflash stock firmware in that case. - Existing Spoolman spool mappings: the mapping format changed with SpoolLink — mappings are no longer stored in
Lot Nr, but in a newExtra Fields > Card UIDfield. Existing mappings need to be moved over manually in Spoolman (strip thecard_uid:prefix when moving the value). - Tags carrying an OpenSpool
spool_id: SpoolLink does not readspool_idoff the tag, onlycard_uids. Re-scan those tags with one of the mobile apps in the table above to migrate them to acard_uidslink.
Found an issue or have feedback on Spoolman/SpoolLink/the apps? Please use this issue to report it, rather than opening a new one — it helps us track feedback on this feature in one place.
Revert
- Download
.binfrom the Snapmaker U1 Wiki. - Follow the same as for install.
Community
Join the Snapmaker Discord and visit the #u1-printer channel to connect with other users using the custom firmware, share experiences, and get help.
Support
If you find this project useful and would like to support its development, you can:
🖨️ Buy a Snapmaker U1 — ordering via the link below supports this project. Optionally use code PAXX12CUSTOM for $20 off, or any other discount you find online:
- EU store: https://snapmaker-eu.myshopify.com?ref=paxx12
- US store: https://snapmaker-us.myshopify.com?ref=paxx12
- Global store: https://test-snapmaker.myshopify.com?ref=paxx12