Skip to content

Repository files navigation

Guppy Screen for Klipper

Guppy Screen is a touch UI for Klipper using APIs exposed by Moonraker. It builds on LVGL as a standalone executable, has no dependency on any display servers such as X/Wayland.

#### Added chamber tempereture to print status page (forked from Koenpunt) and changed extruder page (temp list and speed and lenght list) 2026.03.03. PyCos

Install script pointed to current repo. 2026.03.10 build by PyCos

USE THE NIGHTLY MATERIAL INSTALL SCRIPT - TESTED 2026.03.16 on K1C @ PyCos

Installation / Update

Run the following interactive script via SSH on your K1/Max/CR-10 SE/Ender 3 V3 KE/Nebula Pad to install Guppy Screen.

Material Design Theme - fixed URL 2026.03.16

sh -c "$(wget --no-check-certificate -qO - https://raw.githubusercontent.com/PyCos/guppyscreen/refs/heads/main/scripts/installer.sh)"

Z-Bolt Theme (Only for the K1/Max) - fixed URL 2026.03.16 - NOT TESTED !

sh -c "$(wget --no-check-certificate -qO - https://raw.githubusercontent.com/PyCos/guppyscreen/refs/heads/main/scripts/installer.sh)" -s zbolt

Nightly Builds

Material (Nightly) - FIXED 2026.03.16. THIS IS LATEST VERSION - WORKING SOLUTION 2026.03.16. PyCos

sh -c "$(wget --no-check-certificate -qO - https://raw.githubusercontent.com/PyCos/guppyscreen/refs/heads/main/scripts/installer.sh)" -s nightly

Uninstall

ssh into your K1/Max and run the following command:

/usr/data/guppyscreen/reinstall-creality.sh

Features

✅ Console/Macro Shell
✅ Bedmesh
✅ Input Shaper (PSD graphs)
✅ Belt Calibration/Excitate
✅ Print Status
✅ Spoolman Integration
✅ Extrude/Retract
✅ Temperature Control
✅ Fans/LED/Move Control
✅ Fine Tune (speed, flow, z-offset, Pressure Advance)
✅ Limits (Velocity, Acel, Square Corner Velocity, etc.)
✅ File Browser
✅ Supports multiple screen resolutions
✅ Cross platform releases (MIPS/ARM/x86)
✅ TMC Metrics
✅ Multi-Printer support

Roadmap

‼️ Exclude Object
‼️ Firmware Retraction

Open for feature requests.

Documentation

You can find various Guppy Screen documents here.

Screenshot

Material Theme - ORIGINAL SCREENSHOTS - NOT UPDATED by me

Material Theme Guppy Screen

Earlier development screenshots can be found here

Video Demo

https://www.reddit.com/r/crealityk1/comments/17jp59g/new_touch_ui_for_the_k1/

Credits

Guppyscreen | Material Design Icons | Z-Bolt Icons | Moonraker | KlipperScreen | Fluidd | Klippain-shaketune

About

Forked from probielodan/guppyscreen and merged 2 branch from koenpunt , furthermore improved the Guppy macros (Cooldown, Load and Quit) and extended Extrusion panel capabilites

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages