Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
92 commits
Select commit Hold shift + click to select a range
c195446
Fix alpha parsing for OpenSpool on OpenRFID (#447)
suchmememanyskill May 10, 2026
72cfe8e
Add `hidden` support to `firmware-config` (#449)
paxx12 May 11, 2026
2263070
Add initial re-implementation of the RKNN AI detection (`68-app-camer…
paxx12 May 11, 2026
8593d7e
Add `_PRINT_START_*`, `_PRINT_END_*`, or `_CANCEL_PRINT_*` lifecycle …
paxx12 May 11, 2026
b2fc5c3
Validate kernel version and cache kernel modules (#452)
paxx12 May 12, 2026
8341090
Add `inputs` support for `firmware-config` settings options #443
paxx12 May 14, 2026
ec257cf
Update `filament_detect/set` to add `MULTI_MODE`, `RGB_2..5`, and `CO…
paxx12 May 17, 2026
ba95b2a
Regroup `firmware-config` settings and rewrite print-preference tweak…
paxx12 May 17, 2026
c25d9f5
Fix Printer Preferences to apply changes only when in printing state …
paxx12 May 17, 2026
7677e69
Simplify store referral block across docs [ci skip] (#461)
paxx12 May 17, 2026
b9bb582
Use draft release instead of pre-release (#462)
paxx12 May 17, 2026
dbbddc4
Add `has` subcommand to `extended-config.py` (#468)
paxx12 May 21, 2026
275e171
Add Panda Breath firmware-config integration
justinh-rahb May 14, 2026
e7c553e
Rework Panda Breath firmware-config and CLI
paxx12 May 17, 2026
c47a5f9
Bump base firmware to `v1.4.0`
paxx12 May 25, 2026
f87a70c
Fix RFID patch 02 and `COLOR_NUMS` overflow for `v1.4.0`
paxx12 May 25, 2026
e13e3cd
Remove `light_spot` from camera AI bed-check labels
paxx12 May 25, 2026
c669894
Add `FORCE` support to `SET_PRINT_PREFERENCES` and rework force macros
paxx12 May 26, 2026
63b028b
Fix `copy` usage in RFID patches for `v1.4.0`
paxx12 May 26, 2026
f64e5ca
Enable `tigertag_tag_processor` by default in base config #481
paxx12 May 27, 2026
943018b
Add Panda Breath chamber heater documentation (#483)
paxx12 May 28, 2026
c6b30b5
Improve `firmware-config` layout (#486)
paxx12 May 28, 2026
7e4c331
Add eMMC health and performance status to `firmware-config` (#478)
paxx12 May 28, 2026
6545a65
Re-order print preferences overlay to slot `36` (#488)
paxx12 May 29, 2026
aaf1918
Update `HEROES.md` [ci skip]
paxx12 Jun 2, 2026
fb8cea0
Update RELEASE.md [ci skip]
paxx12 Jun 2, 2026
17af84e
Update firmware requirement for Panda Breath device [ci skip]
paxx12 Jun 2, 2026
83275fa
Fix Panda Breath provisioning for pristine devices (#506)
paxx12 Jun 7, 2026
eca5c40
Ignore `__pycache__/` directories [ci skip] (#513)
paxx12 Jun 8, 2026
f594171
Update firmware to `1.4.1` (#518)
paxx12 Jun 11, 2026
1073885
Suppress `eth0` error on WiFi-only devices in Panda Breath setup (#522)
paxx12 Jun 13, 2026
655bdc4
Add klipper patches for AHT2x/AHT3x sensor support and `temperature_c…
jimmyjon711 Jun 13, 2026
671b51c
Document `firmware-config` web interface for SSH (#520)
St0rmingBr4in Jun 13, 2026
057b568
Update OpenRFID to support SpoolEase (#497)
suchmememanyskill Jun 14, 2026
49ebefc
Add PR checkout helper and fix firmware upgrade path [ci skip] (#524)
paxx12 Jun 14, 2026
27b815b
Add `CARD_TYPE` field and refine `CARD_UID` semantics across RFID sta…
paxx12 Jun 14, 2026
ea01485
Upgrade `fluidd` to v1.37.1 (#525)
paxx12 Jun 14, 2026
599baa8
Add `quick_actions` and component upgrade support (#512)
paxx12 Jun 15, 2026
853fd3e
Update OctoEverywhere to `5.1.0 (#526)
paxx12 Jun 15, 2026
21df9be
Add virtio GPU and multitouch support to QEMU dev environment (#529)
paxx12 Jun 16, 2026
296ee91
Disable access log for `/screen/snapshot` (#534)
paxx12 Jun 16, 2026
2b013e4
Disable `access_log` globally in mainsail nginx config (#536)
paxx12 Jun 16, 2026
4cb3a6d
Add `full-recover.txt` USB recovery variant (#547)
paxx12 Jun 21, 2026
1ebc2ba
Update firmware to `1.5.1` (#554)
paxx12 Jul 5, 2026
c7a4e66
Rework `-devel` profile suffix into composable `overlays/profile-*` o…
paxx12 Jul 6, 2026
d3be708
Rename `overlays/profile-*` to `overlays/addon-*` (#562)
paxx12 Jul 7, 2026
a395967
Introduce user mods support (#563)
paxx12 Jul 7, 2026
0227b99
Move `paxx12-ai` camera AI detection into personal `overlays/mods/pax…
paxx12 Jul 13, 2026
ff2ffa5
Support `if_cmd` for settings items in `firmware-config` (#573)
paxx12 Jul 13, 2026
8b5f710
Add camera resolution/framerate settings to `firmware-config` (#574)
paxx12 Jul 13, 2026
93a1fa3
Add firmware-upgrade imposter and force-block Snapmaker auto-updates …
paxx12 Jul 13, 2026
276a71a
Add extensible service hooks (#577)
paxx12 Jul 14, 2026
12ca761
Update Fluidd to `v1.37.2` (#578)
paxx12 Jul 14, 2026
d7369fb
Update Mainsail to `v2.18.2` (#579)
paxx12 Jul 14, 2026
5f52c61
Update OpenRFID to align RFID reset timeouts with firmware `1.4.0` (#…
paxx12 Jul 14, 2026
70726ac
Add Filament Manager UI (#581)
paxx12 Jul 14, 2026
bad8efb
Add Spoolman/SpoolLink integration (#491)
paxx12 Jul 14, 2026
cb5521c
Derive `EXTRACT_DIR` per firmware version and prune unused images (#588)
paxx12 Jul 15, 2026
3cc6cfd
Update firmware to `1.5.2` (#587)
paxx12 Jul 15, 2026
8c20d3e
Fix `[components] rfid` disabling the RFID reader by default (#589)
paxx12 Jul 15, 2026
b959261
Update firmware to `1.5.2` build `.12` (#591)
paxx12 Jul 16, 2026
868c13d
Drop card resolution from the Klipper `spoollink` router (#586)
paxx12 Jul 17, 2026
cc89fd9
Support Panda Breath v1.0.4 (#594)
plastikman Jul 19, 2026
d55148b
Allow to upgrade firmware using `.zip` (#585)
Tareku99 Jul 19, 2026
6e3b182
Fix chroot `/root` cache persistence in `create_firmware.sh` (#596)
paxx12 Jul 19, 2026
9a9bdbd
Set `cavity_led` PWM to 300Hz to fix camera flicker (#575)
paxx12 Jul 19, 2026
be87811
Replace the per-app `*-pkg` scripts with a shared `extended-pkg` (#59…
paxx12 Jul 19, 2026
29a2326
Update OctoEverywhere to `5.1.1` (#601)
paxx12 Jul 19, 2026
8cb0b4e
Restructure RFID docs and document community apps (#602)
paxx12 Jul 29, 2026
46377ab
Add `v1.5.2-paxx12-21` heroes (#607)
paxx12 Jul 29, 2026
5405b8d
Update firmware to `1.5.2` build `.13` (#608)
paxx12 Jul 30, 2026
aa1156c
Fix confirm modal being unreachable on short viewports (#612)
paxx12 Aug 1, 2026
e171e96
Document Spoolman/SpoolLink app tag support and known conflicts (#613)
paxx12 Aug 1, 2026
4664698
feat(AFC): Adding patches for moonraker and fixing thumbnail not show…
jimmyjon711 Aug 1, 2026
8d97e83
AFC: Enable CAN bus upon boot (#523)
jimmyjon711 Aug 1, 2026
e47e7ea
SpoolPainter: Add EU and Global Snapmaker store links (#618)
ni4223 Aug 2, 2026
0f76b35
Add `docs/screenshots` and link screenshots into docs [ci skip] #638
paxx12 Aug 13, 2026
4bd650e
Use full-resolution screenshots for `fluidd.png` and `firmware-config…
paxx12 Aug 13, 2026
eb130bf
Allow manual dispatch of `Deploy to Cloudflare Pages` workflow [ci sk…
paxx12 Aug 13, 2026
c45abb8
Move `SET_SPOOL_ID` from `afc.cfg` to `spoollink.cfg` (#624)
paxx12 Aug 22, 2026
4ba04a9
SpoolPainter - add Polymaker referral link (@ni4223) (#651)
ni4223 Aug 23, 2026
2f7b3f5
Link Spool Studio v3 release (#625)
GeorgHo Aug 23, 2026
0ad7fe4
Add `CARD_EVENT_TIME` and use it to trigger SpoolLink resolves (#657)
paxx12 Aug 25, 2026
7312b3a
Update fluidd to `v1.37.4` (#646)
jimmyjon711 Aug 25, 2026
f1c4fc5
Update firmware to `1.6.0` (#648)
paxx12 Aug 25, 2026
79ad6b4
Fix Moonraker zeroconf mDNS not resolving after boot (#658)
lagnat Aug 25, 2026
6d9c3ea
Pass access token to websocket connection in filament manager (#659)
krzmaz Aug 25, 2026
78dba93
Add SPDX license headers to project source files (#664)
paxx12 Aug 25, 2026
b70cee5
Add DragonBreath as a chamber-heater option alongside Panda Breath (#…
paxx12 Aug 26, 2026
7dcf2bb
Add an opt-in action to migrate Panda Breath to DragonBreath over Wi-…
paxx12 Aug 26, 2026
268d5c7
Bump v4l2-mpp and screen-apps pins, fix requirements.txt install (#668)
paxx12 Aug 26, 2026
89a2128
Improve extended services performance
paxx12 Aug 17, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .github/FUNDING.yml
Original file line number Diff line number Diff line change
@@ -1 +1,5 @@
# SPDX-License-Identifier: GPL-3.0-or-later
# SPDX-PackageHomePage: https://github.com/paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware
# SPDX-FileCopyrightText: Copyright (c) 2025 @paxx12

buy_me_a_coffee: paxx12
4 changes: 4 additions & 0 deletions .github/dev/Dockerfile
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
# SPDX-License-Identifier: GPL-3.0-or-later
# SPDX-PackageHomePage: https://github.com/paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware
# SPDX-FileCopyrightText: Copyright (c) 2025-2026 @paxx12, @horzadome

FROM debian:trixie

# The ccache is installed separately
Expand Down
5 changes: 5 additions & 0 deletions .github/workflows/cloudflare_pages.yaml
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
# SPDX-License-Identifier: GPL-3.0-or-later
# SPDX-PackageHomePage: https://github.com/paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware
# SPDX-FileCopyrightText: Copyright (c) 2026 @paxx12

name: Deploy to Cloudflare Pages

on:
Expand All @@ -10,6 +14,7 @@ on:
- 'docs/**'
- 'scripts/build_docs.sh'
- '.github/workflows/cloudflare_pages.yaml'
workflow_dispatch:

jobs:
deploy:
Expand Down
6 changes: 5 additions & 1 deletion .github/workflows/pre_release.yaml
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
# SPDX-License-Identifier: GPL-3.0-or-later
# SPDX-PackageHomePage: https://github.com/paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware
# SPDX-FileCopyrightText: Copyright (c) 2025 @paxx12, @horzadome

on:
push:
branches:
Expand Down Expand Up @@ -67,7 +71,7 @@ jobs:
tag: "v${{ env.GIT_VERSION }}"
allowUpdates: false
updateOnlyUnreleased: true
prerelease: true
draft: true
bodyFile: RELEASE.md
artifacts: "U1_*_upgrade.bin"

Expand Down
13 changes: 4 additions & 9 deletions .github/workflows/pull_request.yaml
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
# SPDX-License-Identifier: GPL-3.0-or-later
# SPDX-PackageHomePage: https://github.com/paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware
# SPDX-FileCopyrightText: Copyright (c) 2025 @paxx12, @horzadome

name: Build

on:
Expand Down Expand Up @@ -97,19 +101,11 @@ jobs:
- name: Build with Extended Fluidd firmware
run: ./dev.sh make build PROFILE=extended OUTPUT_FILE=U1_extended_${{ env.GIT_VERSION }}_upgrade.bin

- name: Build DEVEL version of Extended Fluidd firmware
run: ./dev.sh make build PROFILE=extended-devel OUTPUT_FILE=U1_extended_${{ env.GIT_VERSION }}_devel.bin

- uses: actions/upload-artifact@v4
with:
name: extended-build
path: U1_extended_*_upgrade.bin

- uses: actions/upload-artifact@v4
with:
name: extended-devel-build
path: U1_extended_*_devel.bin

- name: Save PR info
if: github.event_name == 'pull_request'
run: |
Expand All @@ -122,7 +118,6 @@ jobs:
echo "${{ env.JOB_START }}" > pr-info/job_start
echo "$(date +%s)" > pr-info/job_end
echo extended-build >> pr-info/artifacts
echo extended-devel-build >> pr-info/artifacts

- name: Upload PR info
if: github.event_name == 'pull_request'
Expand Down
4 changes: 4 additions & 0 deletions .github/workflows/pull_request_comment.yaml
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
# SPDX-License-Identifier: GPL-3.0-or-later
# SPDX-PackageHomePage: https://github.com/paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware
# SPDX-FileCopyrightText: Copyright (c) 2026 @paxx12

name: PR Comment

on:
Expand Down
4 changes: 4 additions & 0 deletions .github/workflows/update_release_pr.yaml
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
# SPDX-License-Identifier: GPL-3.0-or-later
# SPDX-PackageHomePage: https://github.com/paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware
# SPDX-FileCopyrightText: Copyright (c) 2026 @paxx12

name: Update Release PR Changelog

on:
Expand Down
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,8 +1,11 @@
firmware/
tmp/
*.o
*.so
tools/upfile/upfile
tools/rk2918_tools/afptool
tools/rk2918_tools/img_maker
tools/rk2918_tools/img_unpack
tools/rk2918_tools/mkkrnlimg
_site/
__pycache__/
23 changes: 22 additions & 1 deletion HEROES.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,30 @@ You can thank them here:
| [@Argolein](https://github.com/Argolein) | `@Argolein` | TMC motor driver optimizations and Klipper patches | |
| [@mcristina422](https://github.com/mcristina422) | | Tailscale VPN remote access | |
| [@MaxKaenner](https://github.com/MaxKaenner) | | Filament auto-replenish bug fix | |
| [@justinh-rahb](https://github.com/justinh-rahb) | `@wildtang3nt` | V4L2 camera controls and Mainsail Remote Screen support | [![Buy Me A Coffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/wildtang3nt) |
| [@justinh-rahb](https://github.com/justinh-rahb) | `@wildtang3nt` | V4L2 camera controls, Mainsail Remote Screen support, Panda Breath chamber heater | [![Buy Me A Coffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/wildtang3nt) |
| [@suchmememanyskill](https://github.com/suchmememanyskill) | `@Sims` | OpenRFID | [![Ko-Fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/suchmememanyskill) |
| [@morgendagen](https://github.com/morgendagen) | | OpenSpool `subtype` field for material specification | |
| [@Tareku99](https://github.com/Tareku99) | | `.zip` firmware upload support in `firmware-config` | |
| [@plastikman](https://github.com/plastikman) | | Panda Breath firmware `V1.0.4` support | |
| [@djgringoboy2003](https://github.com/djgringoboy2003) | | Root-caused the `cavity_led` PWM camera flicker | |

---

## v1.5.2-paxx12-21

| Contributor | Contribution | PR |
|---|---|---|
| [@Tareku99](https://github.com/Tareku99) | Allow firmware upgrades from a `.zip` archive | [#585](https://github.com/paxx12/SnapmakerU1-Extended-Firmware/pull/585) |
| [@plastikman](https://github.com/plastikman) | Accept Panda Breath stock firmware `V1.0.4` when binding | [#594](https://github.com/paxx12/SnapmakerU1-Extended-Firmware/pull/594) |
| [@djgringoboy2003](https://github.com/djgringoboy2003) | Investigated and root-caused the `cavity_led` PWM camera flicker | [#575](https://github.com/paxx12/SnapmakerU1-Extended-Firmware/pull/575) |

---

## v1.4.0-paxx12-18

| Contributor | Contribution | PR |
|---|---|---|
| [@justinh-rahb](https://github.com/justinh-rahb) | Panda Breath chamber heater support | [#347](https://github.com/paxx12/SnapmakerU1-Extended-Firmware/pull/347) |

---

Expand Down
37 changes: 23 additions & 14 deletions Makefile
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
# SPDX-License-Identifier: GPL-3.0-or-later
# SPDX-PackageHomePage: https://github.com/paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware
# SPDX-FileCopyrightText: Copyright (c) 2025 @paxx12, @horzadome

include vars.mk

all: tools
Expand All @@ -8,31 +12,35 @@ OUTPUT_FILE := firmware/firmware.bin
BUILD_DIR ?= tmp/firmware

ifneq (,$(PROFILE))
PROFILE_MAIN := $(patsubst %-devel,%,$(PROFILE))
PROFILE_PARTS := $(subst -, ,$(PROFILE))
FIRMWARE_NAME := $(firstword $(PROFILE_PARTS))
MOD_NAMES := $(wordlist 2,$(words $(PROFILE_PARTS)),$(PROFILE_PARTS))
OVERLAYS += $(wildcard overlays/common/*/)
OVERLAYS += $(wildcard overlays/firmware-$(PROFILE_MAIN)/*/)
ifneq ($(filter %-devel,$(PROFILE)),)
OVERLAYS += $(wildcard overlays/devel/*/)
endif
OVERLAYS += $(wildcard overlays/firmware-$(FIRMWARE_NAME)/*/)
OVERLAYS += $(foreach p,$(MOD_NAMES),$(wildcard overlays/mods/$(p)/*/))
endif

PROFILES := $(patsubst overlays/firmware-%,%,$(wildcard overlays/firmware-*))
PROFILES += $(patsubst overlays/firmware-%,%-devel,$(wildcard overlays/firmware-*))
FIRMWARES := $(patsubst overlays/firmware-%,%,$(wildcard overlays/firmware-*))
MOD_LIST := $(patsubst overlays/mods/%/,%,$(wildcard overlays/mods/*/))
INVALID_MOD_NAMES := $(filter-out $(MOD_LIST),$(MOD_NAMES))

$(OUTPUT_FILE): firmware/$(FIRMWARE_FILE) tools
ifeq (,$(PROFILE))
@echo "Please specify a profile using 'make PROFILE=<profile_name>'. Available profiles are: $(PROFILES)."
@echo "Please specify a firmware using 'make PROFILE=<firmware>[-<mod>]*'. Available firmwares are: $(FIRMWARES). Available mods are: $(MOD_LIST)."
@exit 1
else ifeq (,$(filter $(FIRMWARE_NAME),$(FIRMWARES)))
@echo "Invalid firmware '$(FIRMWARE_NAME)'. Available firmwares are: $(FIRMWARES)."
@exit 1
else ifeq (,$(filter $(PROFILE_MAIN),$(PROFILES)))
@echo "Invalid profile '$(PROFILE_MAIN)'. Available profiles are: $(PROFILES)."
else ifneq (,$(INVALID_MOD_NAMES))
@echo "Invalid mod(s) '$(INVALID_MOD_NAMES)'. Available mods are: $(MOD_LIST)."
@exit 1
endif
./scripts/create_firmware.sh $< $(BUILD_DIR) $@ $(OVERLAYS)

.PHONY: build
build: $(OUTPUT_FILE)

EXTRACT_DIR := tmp/extracted
EXTRACT_DIR := tmp/extracted-$(FIRMWARE_VERSION)

.PHONY: extract
extract: firmware/$(FIRMWARE_FILE) tools
Expand All @@ -42,9 +50,10 @@ extract: firmware/$(FIRMWARE_FILE) tools
overlays:
@echo $(OVERLAYS)

.PHONY: profiles
profiles:
@echo "Available profiles: $(PROFILES)"
.PHONY: mods
mods:
@echo "Available firmwares: $(FIRMWARES)"
@echo "Available mods: $(MOD_LIST)"

# ================= Tools =================

Expand Down
8 changes: 1 addition & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,13 +56,7 @@ If you find this project useful and would like to support its development:

[![Buy Me A Coffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/paxx12)

🖨️ **Buy a Snapmaker Printer from Official Store** - use referral link and discount code `PAXX12` to get 5% discount on any purchase

* EU store: [https://snapmaker-eu.myshopify.com?ref=paxx12](https://snapmaker-eu.myshopify.com?ref=paxx12)
* US store: [https://snapmaker-us.myshopify.com?ref=paxx12](https://snapmaker-us.myshopify.com?ref=paxx12)
* Global store: [https://test-snapmaker.myshopify.com?ref=paxx12](https://test-snapmaker.myshopify.com?ref=paxx12)

🖨️ **Buy a Snapmaker Printer from Official Store** - use discount code `PAXX12CUSTOM` to get $20 off Snapmaker U1 printer
🖨️ **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](https://snapmaker-eu.myshopify.com?ref=paxx12)
* US store: [https://snapmaker-us.myshopify.com?ref=paxx12](https://snapmaker-us.myshopify.com?ref=paxx12)
Expand Down
18 changes: 8 additions & 10 deletions RELEASE.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@

> **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](https://www.snapmaker.com/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
Expand All @@ -14,6 +16,10 @@

See [HEROES.md](HEROES.md) for all-time contributors.

## Screenshots

<!-- PLACEHOLDER: add screenshots here -->

## Install

For detailed installation instructions, see the [Installation Guide](docs/install.md).
Expand All @@ -26,9 +32,7 @@ Quick steps:

## Troubleshooting

- **Configuration change**: Since the `v1.1.0` all features has to be configured with http://IP/firmware-config.
- **Klipper failed to start**: Open Firmware Config at `http://IP/firmware-config`, go to `Recovery` and select `Reset Extended to Defaults`. This will reset all extended settings and reboot the printer.
- **AFC-Lite Stub**: Has number of [limitations](http://snapmakeru1-extended-firmware.pages.dev/afc-lite#limitations).
- **Custom extensions installed via SSH**: Installing third-party extensions or modifications over SSH (for example [helixscreen](https://github.com/prestonbrown/helixscreen)) can break the system. Because such changes are made outside the supported extended configuration, the built-in recovery may not undo them, and in some cases the system becomes very hard to recover. Do this only if you understand the risks and know how to restore the printer. If something breaks, try recovery in order: first `extended-recover.txt` (resets extended configuration), then `full-recover.txt` (also clears persisted changes, printer data and the debug flag), and only if neither works, reflash stock firmware via the [Snapmaker U1 Wiki](https://wiki.snapmaker.com/en/snapmaker_u1/firmware/release_notes).

## Revert

Expand All @@ -45,13 +49,7 @@ If you find this project useful and would like to support its development, you c

[![Buy Me A Coffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/paxx12)

🖨️ **Buy a Snapmaker Printer from Official Store** - use referral link and discount code `PAXX12` to get 5% discount on any purchase

* EU store: [https://snapmaker-eu.myshopify.com?ref=paxx12](https://snapmaker-eu.myshopify.com?ref=paxx12)
* US store: [https://snapmaker-us.myshopify.com?ref=paxx12](https://snapmaker-us.myshopify.com?ref=paxx12)
* Global store: [https://test-snapmaker.myshopify.com?ref=paxx12](https://test-snapmaker.myshopify.com?ref=paxx12)

🖨️ **Buy a Snapmaker Printer from Official Store** - use discount code `PAXX12CUSTOM` to get $20 off Snapmaker U1 printer
🖨️ **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](https://snapmaker-eu.myshopify.com?ref=paxx12)
* US store: [https://snapmaker-us.myshopify.com?ref=paxx12](https://snapmaker-us.myshopify.com?ref=paxx12)
Expand Down
5 changes: 4 additions & 1 deletion dev.sh
Original file line number Diff line number Diff line change
@@ -1,4 +1,7 @@
#!/usr/bin/env bash
# SPDX-License-Identifier: GPL-3.0-or-later
# SPDX-PackageHomePage: https://github.com/paxx12-snapmaker-u1/SnapmakerU1-Extended-Firmware
# SPDX-FileCopyrightText: Copyright (c) 2025-2026 @paxx12, @liberodark

set -e

Expand All @@ -15,4 +18,4 @@ TTY_FLAG=""

ENV_FLAGS="-e GIT_VERSION -e CI -e PASSWORD"

exec docker run --rm $DOCKER_OPTS $TTY_FLAG $ENV_FLAGS --cap-add=SYS_ADMIN -w "$PWD" -v "$PWD:$PWD" "$IMAGE_NAME" "$@"
exec docker run --rm $DOCKER_OPTS $TTY_FLAG $ENV_FLAGS -w "$PWD" -v "$PWD:$PWD" "$IMAGE_NAME" "$@"
4 changes: 4 additions & 0 deletions docs/afc-lite.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,3 +76,7 @@ rm /oem/printer_data/config/extended/klipper/afc.cfg

![AFC Tools Remapping](images/afc_tools.gif)

## See Also

- [Spoolman Integration](spoolman.md) — automatic spool lookup, card UID binding, and active spool tracking via the SpoolLink component

28 changes: 28 additions & 0 deletions docs/camera_support.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ The extended firmware includes hardware-accelerated camera support with WebRTC s
- MIPI CSI internal camera and USB camera support
- Low-latency WebRTC streaming (best quality and performance)
- Hot-plug detection for USB cameras
- Configurable resolution/framerate presets (paxx12 service only)
- Web-based camera controls with settings persistence
- Optional RTSP streaming support
- Compatible with AI detection and Snapmaker Cloud features
Expand Down Expand Up @@ -131,6 +132,8 @@ aspect_ratio: 16:9
- `mjpegstreamer-adaptive` - MJPEG streaming (best compatibility, most resource intensive)
- No stream_url needed (uses snapshot_url only)

<img src="images/usb_cam.png" alt="Fluidd USB camera settings" width="300"/>

**Step 3:** Reboot the printer for changes to take effect.

To disable USB camera, set `usb: none` in extended2.cfg.
Expand All @@ -139,6 +142,31 @@ When enabled, USB cameras are accessible at `http://<printer-ip>/webcam2/`.

Note: Only one streaming mode can be active per camera.

### Resolution & Framerate

Available for the paxx12 camera service only.

The internal camera is fixed at 1080p (required for AI detection); only framerate can be lowered. The USB camera can be lowered in both resolution and framerate to reduce bandwidth/CPU usage.

#### Using firmware-config Web UI (preferred)

Navigate to the [firmware-config](firmware_config.md) web interface, go to the Camera section, and select **Internal Camera Resolution** and/or **USB Camera Resolution**. These options only appear once the corresponding camera is set to the paxx12 service.

#### Manual Setup (advanced)

**Step 1:** Edit `/home/lava/printer_data/config/extended/extended2.cfg`:
```ini
[camera]
internal_resolution: 1080p25
usb_resolution: 720p25
```

Internal camera options: `1080p30`, `1080p25` (default), `1080p15`, `1080p5`.

USB camera options: `1080p30`, `1080p25` (default), `1080p5`, `720p30`, `720p25`, `720p5`, `360p30`, `360p25`, `360p5`.

**Step 2:** Restart the relevant camera service (`S99v4l2-mpp-mipi` or `S99v4l2-mpp-usb`) or reboot the printer for changes to take effect.

### RTSP Streaming

RTSP streaming is disabled by default (paxx12 service only).
Expand Down
2 changes: 1 addition & 1 deletion docs/cloud.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ Navigate to the [firmware-config](firmware_config.md) web interface, go to the R
**Step 1:** Download OctoEverywhere (requires internet connection):
```bash
ssh root@<printer-ip>
octoeverywhere-pkg download
extended-pkg octoeverywhere download
```

**Step 2:** Edit `extended/extended2.cfg`, set the `cloud`:
Expand Down
Loading
Loading