What's new in v1.4.0
A feature release: a guided calibration hub, a reworked WiFi/Static IP experience, and a batch of
migration-safety fixes for anyone coming from stock Creality, an older OpenKE/GuppyKE version, or the
Creality Helper Script.
⚠️ You need to re-run the full installer to get this update — the in-app "Update Guppy" button on
its own is not enough. "Update Guppy" refreshes the screen app itself (binary + its own small set of
helper scripts), so you'll see the new UI. But most of what this release actually changes lives
outside that: the new E-Steps Calibration macros, the installer's migration-safety fixes, and the
vendored Moonraker/Nginx. None of that is something "Update Guppy" touches — only the full installer
applies it. See Upgrading below.
One button for every calibration routine
Tune tab now has a single Calibration button that walks you through every routine — Axis Twist,
Z-offset + bed mesh, Input Shaper, E-Steps, Skew, TMC Autotune — as a numbered list, in the order you
should actually do them in. No more hunting across a grid of tiles to figure out what to run first.
- New: guided Recalibration Wizard. Z-offset and bed-mesh calibration used to be two separate manual
jobs. Now it's one flow: set your Z-offset (paper or BLTouch), then it meshes the bed automatically and
lets you review and save. There's also an optional extra step that checks your result against the
KE's built-in nozzle load sensor as a second opinion — purely informational, shown side by side, never
applied automatically. - New: guided E-Steps Calibration. Heats the extruder for you, marks the filament, pushes a measured
length through, and does the math for you once you tell it how far the mark actually moved. No more
working out the ratio by hand.
WiFi, rebuilt
- Networks are now grouped into Known networks and Other networks in range, with real signal-
strength bars, and the list no longer jumps around every time it rescans. - Fixed a real bug: a mistap near your connected network could accidentally delete its saved
password instead of opening its settings. That's no longer possible — connecting, forgetting, and
viewing details are now clearly separate taps. - New: Network Details screen — see your signal, security type, and IP address, with clear
"Configure Static IP" and "Forget This Network" buttons. - New Static IP screen — each part of the address is its own tap-sized box (instead of one long
text field), and typing something invalid flags it red right away instead of only failing when you
hit Save. Switching back to DHCP is now its own clear button, not a side effect of tapping a tab. - Fixed a bug where saving or reverting a static IP could freeze the whole screen.
Adaptive mesh, purge & park: one line in your slicer
If you use OpenKE's adaptive bed meshing, purge line, and park-while-heating together, you can now set
all three up with one macro instead of three:
START_PRINT BED_TEMP=[bed_temperature_initial_layer_single] EXTRUDER_TEMP=[nozzle_temperature_initial_layer] BRIM_WIDTH=[brim_width]Drop that into your slicer's start G-code and START_PRINT handles the whole opening sequence for you —
homing, heating, an adaptive mesh sized to just your print (not the whole bed), parking the nozzle next
to the print while it heats, and an adaptive purge line — in the right order, so you don't have to wire
up and sequence the individual macros yourself. Don't want one of the three steps? Add SKIP_MESH=1,
SKIP_PARK=1, or SKIP_PURGE=1 and it skips just that part. (Prefer full manual control instead? The
three macros are still there to call yourself.) Full guide:
Adaptive Print Setup.
This feature also no longer depends on the third-party KAMP project under the hood — if you had KAMP
installed already, the installer detects it, carries over your settings, and cleans up the old files
automatically.
Installer: safer if you're migrating from something else
If you're coming from stock Creality, an older OpenKE/GuppyKE install, or the Creality Helper Script,
this release specifically targets you:
- Save Z-Offset, M600, useful macros, and now E-Steps Calibration all offer to safely take over from
an existing setup instead of just refusing to install forever. Your old file is backed up first, and
it's only touched if nothing else on your printer still relies on it. - That safety check is now much more thorough — it looks across your entire printer config, not just
one file, so it won't miss another macro somewhere else that still depends on the thing it's about to
replace. Found and fixed against a real printer with a Creality Helper Script install still running on
it, as part of getting this release ready. - Downloads during install are now more reliable — if the GuppyScreen app itself or Moonraker fails to
download properly partway through, the installer notices and retries instead of quietly continuing
with a broken install. - Re-running the installer on a printer that already has Moonraker now double-checks it's actually
running (and restarts it if it isn't), instead of assuming it's fine because the files are there. - Exclude Object and adaptive mesh's Moonraker-side setting now gets turned on correctly in more cases
than before. - Moonraker and the optional Mainsail web server are now bundled directly with OpenKE, instead of
being pulled from a separate community project's repo during install — one less thing that can break
if that project ever goes offline. - Mainsail now registers itself with Moonraker so it shows up in Mainsail's own update panel, instead of
needing to be updated by hand.
Also in this release
- Every accent-colored button (Save, Confirm, Start, etc.) now updates immediately if you change the
screen's theme color — some used to stay the old color until you restarted the app. - Want to try new features before they're officially released? There's now a nightly build you can opt
into and test ahead of time. See
Testing bleeding-edge builds.
Upgrading (required for this release)
Run this on the printer itself (over SSH, or from a terminal on the printer):
sh -c "$(wget --no-check-certificate -qO - https://raw.githubusercontent.com/coreflake1/guppyscreen/main/scripts/installer.sh)"Safe to run on an existing install — it detects what you already have and only touches what needs
updating; your calibration values (Z-offset, bed mesh, input shaper, skew) are untouched either way.
Full Changelog: v1.3.1-OpenKE...v1.4.0-OpenKE