paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware v1.4.1-paxx12-20 on GitHub

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

Quick Actions panel in Firmware Config with in-place upgrade buttons for Tailscale and OctoEverywhere #512 (@paxx12)
Full USB recovery via full-recover.txt — wipes printer data and overlays for a clean rebuild from defaults #547 (@paxx12)
SpoolEase spool-tracking support added to OpenRFID (disabled by default) #497 (@suchmememanyskill)
AHT2x/AHT3x temperature sensor support; fixes temperature readings on ViViD and EMU units #496 (@jimmyjon711)
CARD_UID and CARD_TYPE (NTAG/M1) tag metadata added to RFID webhook payloads #448 (@paxx12)
OctoEverywhere upgraded to 5.1.0 — major streaming performance improvements, lower RAM and CPU usage #526 (@paxx12)
Fluidd upgraded to v1.37.1 #525 (@paxx12)
Fix: nginx access log spam on mainsail vhost now silenced globally #536 (@paxx12)
Fix: eth0 error on WiFi-only devices during Panda Breath setup suppressed #522 (@paxx12)

Full changelog: #546

SpoolEase Support in OpenRFID

OpenRFID now supports SpoolEase spool-tracking tags (disabled by default — enable in OpenRFID settings). This update also improves MIFARE Classic handling by skipping retries on authentication failures, and logs additional detail on each tag scan. Contributed by @suchmememanyskill.

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.

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:

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