-
Notifications
You must be signed in to change notification settings - Fork 2
Resetting and Uninstalling
OpenKE gives you two ways to go back to stock. They do very different things — pick the right one.
| I want to… | Use |
|---|---|
| Remove OpenKE's screen and mods, but keep all my Klipper config and print files | Uninstall |
| Wipe everything — configs, gcodes, OpenKE, all of it — and start from zero | Factory reset |
| My screen is black / SSH is dead / nothing works | Factory reset via USB (works even with no screen) |
The uninstaller removes OpenKE's screen binary, Klipper mods, and system changes. It keeps your
Klipper config (printer.cfg), print files, bed meshes, and calibration data — so you can reinstall
later without recalibrating.
SSH into the printer and run the same installer with the uninstall argument:
sh -c "$(wget --no-check-certificate -qO - https://raw.githubusercontent.com/coreflake1/guppyscreen/main/scripts/installer.sh)" -- uninstall- OpenKE binary and config (
/usr/data/guppyscreen/) - Klipper mods: KAMP configs, Axis Twist module, TMC Autotune config, Skew config
- System patches:
probe.pyis restored from the backup the installer took - Init scripts added by OpenKE (the factory reset service, any camera scripts)
- All your Klipper config (
/usr/data/printer_data/config/) - Print files and thumbnails
- WiFi credentials
- Creality cloud account
If anything wasn't auto-restored, the installer left a backup at
/usr/data/guppyify-backup/— restore files from there manually and reboot.
The stock Creality screen binary comes back on the next reboot. The Klipper interface (Mainsail/Fluidd) still works as normal.
To reinstall OpenKE later, just run the installer again.
A factory reset wipes the printer to exactly how it came from the factory — no configs, no gcodes, no mods. Use this only when you need a truly clean slate or the printer is in an unrecoverable state.
⚠️ This is destructive and not reversible. Your Klipper config, print files, calibration data, and all OpenKE mods are gone. WiFi credentials and the Creality cloud account are preserved.
Works even when the screen is black, Klipper is dead, or SSH isn't responding.
- Format a USB drive as FAT32.
- Create an empty file named exactly
emergency_factory_resetin the root of the drive (no extension, no.txt). - Eject the drive, then plug it into the printer while it is powered off.
- Power the printer on. The service detects the file, renames it to
.old(so it won't repeat), wipes everything, and reboots into stock firmware.
Open Settings → System Info → Reset Options → Factory Reset Printer → red Confirm button.
/etc/init.d/S58factoryreset reset| Path | Outcome |
|---|---|
/overlay/upper/ |
Wiped — all system-level modifications removed |
/usr/data/guppyscreen/ |
Wiped — OpenKE binary and config |
/usr/data/printer_data/ |
Wiped — Klipper config, gcodes, calibration |
/usr/data/printer_data/logs/ |
Kept — logs survive for diagnosis |
/usr/data/wpa_supplicant.conf |
Kept — WiFi credentials survive |
/usr/data/creality/ |
Kept — Creality cloud account & device identity |
The printer boots into stock Creality firmware. To get OpenKE back:
sh -c "$(wget --no-check-certificate -qO - https://raw.githubusercontent.com/coreflake1/guppyscreen/main/scripts/installer.sh)"See Installation for the full guided walkthrough.
Get started
Get great prints
- Calibration walkthrough (A→Z)
- Axis Twist Compensation
- Adaptive meshing + purge
- Square parts (Skew Correction)
- Quieter steppers (TMC Autotune)
Using the screen
Help