Release notes
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.
New Features and Key Changes
Full changelog: paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware#663
Firmware 1.6.0
This release bumps the base Snapmaker firmware to 1.6.0. Upstream changelog:
- Added 0.4 mm high-flow nozzle option in Print Head Information editing.
- Added selectable filament types in the Filament Details page for quicker filament matching.
- Added an AI monitoring issue report function after print completion, available only in Cloud mode, not available in Local Area Network mode.
- Improved the tip-forming effect during filament unloading, reducing the chance of failure caused by filament expansion.
- Enhanced loading and unloading efficiency, shortening waiting times.
- Fixed an issue where the device did not respond when moving the Z-axis in 0.1 mm steps.
- Fixed an abnormal page jump in the Wi-Fi Management page after tapping the Enter key on the soft keyboard.
- Fixed an issue where, after resuming a print job started via the official client, unused channels would still check filament information.
- Fixed an issue where the top-cover setup guide would not display properly after completing the U1 initial setup wizard.
See Snapmaker's official V1.6.0 release notes for the full upstream changelog.
DragonBreath Chamber Heater
@plastikman's open-source DragonBreath firmware - replacing Panda Breath firmware - is now a selectable option in firmware-config under Snapmaker Components > Chamber Heater, alongside Panda Breath, and is now the recommended option.
Nothing about an existing Panda Breath install changes automatically. If you're already on Panda Breath and want to switch, a "Migrate to DragonBreath" action flashes the DragonBreath firmware to your Panda board over Wi-Fi — no USB cable, no internet access needed on the printer or the Panda — then swaps the Klipper config over for you.
Heads up: Panda Breath support is planned for removal in a future release. If you're still on stock Panda Breath firmware, consider migrating to DragonBreath when convenient.
Control Top-Cover fans from Fluidd/Mainsail
The @justinh-rahb contributed change to control official Top Cover fans from Fluidd/Mainsail:
Bypass MCU Mode & Toolhead Simulator
Stock Klipper treats any toolhead MCU connection failure as fatal for the whole printer — one dead board or unplugged cable used to take down all four toolheads. The new "Bypass MCU (Disconnected)" mode lets you disable a toolhead whose board is dead or unplugged entirely, not just one with a bad thermistor, and keep printing on the other three.
Heroes
The Hero of this release is @plastikman, for building and maintaining DragonBreath - the open-source chamber-heater firmware that's now the recommended option for the chamber heater integration.
Install
For detailed installation instructions, see the Installation Guide.
Quick steps:
- Download
.bin and put on FAT32 formatted USB device
- On the printer go to
Settings > About > Firmware Version > Local Update
- Select
.bin and confirm.
Troubleshooting
- Persistent issues after extended recovery: Place
full-recover.txt on 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 new Extra Fields > Card UID field. Existing mappings need to be moved over manually in Spoolman (strip the card_uid: prefix when moving the value).
- Tags carrying an OpenSpool
spool_id: SpoolLink does not read spool_id off the tag, only card_uids. Re-scan those tags with one of the mobile apps in docs/spoolman.md to migrate them to a card_uids link.
- For the most reliable SpoolLink spool resolution, use Snapmaker's built-in RFID Detection System (
firmware-config under Snapmaker Components > RFID Detection System) rather than OpenRFID/alternative detection — alternative systems aren't guaranteed to report a UID for every tag, which SpoolLink needs to resolve a spool.
- DragonBreath migration fails or the device is unreachable: confirm the Panda Breath board has a static DHCP lease and is powered on, then retry the migration from
firmware-config. If it's already been flashed to DragonBreath, the migration step is safe to re-run.
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
.bin from 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:
A new Paxx U1 Extended Firmware release is out:
v1.6.0-paxx12-22The in-app download button updates itself within 24 h (client-side resolver in
renderer/printers/snapmaker/paxx.js).Optional maintenance: bump the
PAXX_FALLBACKconstant in that file at the next convenient release.Release notes
Notice
New Features and Key Changes
1.6.0— see below Update firmware to1.6.0paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware#648 (@paxx12)Stable/Testing/Develop) or disabled entirely, fromfirmware-config— no more manually blocking Snapmaker's auto-update Addfirmware-upgradeimposter to allow firmware upgrades paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware#516 (@paxx12)Force Generic Vendormode to SpoolLink, for Spoolman vendors the U1/Orca doesn't recognize Add force generic vendor mode to SpoolLink paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware#619 (@Dragon2203)fan_genericobjects, controllable from Fluidd/Mainsail andSET_FAN_SPEEDfeat: expose purifier fans as generic fans paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware#673 (@justinh-rahb)SET_SPOOL_IDmissing a fallback for E-prefixed lanes fix(spoollink): add missing fallback for E-prefixed lanes in SET_SPOO… paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware#684 (@Fibdorius)CARD_EVENT_TIMEAddCARD_EVENT_TIMEand use it to trigger SpoolLink resolves paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware#657 (@paxx12)1.6.0firmware-bump PR (#648) Restore five PRs silently reverted by#648paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware#674 (@paxx12)v1.37.4) and Mainsail (v2.19.0) bumped to their latest versionsFull changelog: paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware#663
Firmware
1.6.0This release bumps the base Snapmaker firmware to
1.6.0. Upstream changelog:See Snapmaker's official
V1.6.0release notes for the full upstream changelog.DragonBreath Chamber Heater
@plastikman's open-source DragonBreath firmware - replacing Panda Breath firmware - is now a selectable option in
firmware-configunder Snapmaker Components > Chamber Heater, alongside Panda Breath, and is now the recommended option.Nothing about an existing Panda Breath install changes automatically. If you're already on Panda Breath and want to switch, a "Migrate to DragonBreath" action flashes the DragonBreath firmware to your Panda board over Wi-Fi — no USB cable, no internet access needed on the printer or the Panda — then swaps the Klipper config over for you.
Control Top-Cover fans from Fluidd/Mainsail
The @justinh-rahb contributed change to control official Top Cover fans from Fluidd/Mainsail:
Bypass MCU Mode & Toolhead Simulator
Stock Klipper treats any toolhead MCU connection failure as fatal for the whole printer — one dead board or unplugged cable used to take down all four toolheads. The new "Bypass MCU (Disconnected)" mode lets you disable a toolhead whose board is dead or unplugged entirely, not just one with a bad thermistor, and keep printing on the other three.
Heroes
The Hero of this release is @plastikman, for building and maintaining DragonBreath - the open-source chamber-heater firmware that's now the recommended option for the chamber heater integration.
Install
For detailed installation instructions, see the Installation Guide.
Quick steps:
.binand put on FAT32 formatted USB deviceSettings>About>Firmware Version>Local Update.binand confirm.Troubleshooting
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.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).spool_id: SpoolLink does not readspool_idoff the tag, onlycard_uids. Re-scan those tags with one of the mobile apps in docs/spoolman.md to migrate them to acard_uidslink.firmware-configunder Snapmaker Components > RFID Detection System) rather than OpenRFID/alternative detection — alternative systems aren't guaranteed to report a UID for every tag, which SpoolLink needs to resolve a spool.firmware-config. If it's already been flashed to DragonBreath, the migration step is safe to re-run.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
.binfrom the Snapmaker U1 Wiki.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
PAXX12CUSTOMfor $20 off, or any other discount you find online: