Klipper touch interface · 1.0
Seven AMS and MMU systems run natively, among them Happy Hare, AFC, ACE, CFS and IFS, and every spool is tracked with or without Spoolman. It detects your printer and lays out a home screen for your display, which you can then rearrange however you like. It replaces KlipperScreen or the factory screen in about 15 MB of RAM.
1.0 is the first stable release. Upgrading from 0.99 keeps your settings, layout and printer list.
Prefer to read first? The install guide covers every supported board, plus running the screen on a separate device.
Multi-material
Happy Hare, AFC, ACE, AD5X IFS, Creality CFS, Snapmaker U1 with RFID spool recognition, and tool changers. Filament paths render as 3D tubes, toolheads animate as they move, and buffer health stays on screen for the whole print.
I didn't set out to support seven of them. People kept asking, and the ones who owned the hardware sent patches.
Some of the hardware these backends support. Several units work with more than one.
Happy Hare and AFC get their own interface, so an ERCF or Box Turtle shows its filament path, the spool in each slot and buffer health on the touchscreen. Each spool's remaining weight is tracked as it prints.
The home screen is a grid of widgets you arrange yourself, in any of 18 themes, with layouts of its own for portrait and ultrawide displays. It needs about 15 MB of RAM against KlipperScreen's 50, and no X11.
Factory screens don't support Spoolman. HelixScreen does, and it runs the multi-material units those printers ship with: Creality CFS, the AD5X's IFS and Anycubic ACE.
Klipper and Moonraker stay as they are. Only the screen changes.
One command installs it and stops KlipperScreen for you. On first launch it detects the printer and its hardware, so there is little to configure.
If it isn't for you, --uninstall puts back the screen you had before, stock or KlipperScreen. The install guide has the details for each printer.
Drag widgets around a grid sized to your display, resize them, and spread them across pages like a phone's home screen. First launch sets up a default layout for your screen size, and every change saves as you make it.
Material, color and remaining weight for every spool, kept up to date from what each print extrudes. Connect Spoolman to pull from your inventory, with the spool in each AMS slot and 66 material profiles with drying settings.
Four numbered steps take you through the paper test, starting from homing.
Run the resonance test, read the frequency response chart and save the result, all from the touchscreen.
Thumbnail previews and filenames in a grid that stays fast with hundreds of files.
Total prints, success rate, print time and filament used, plus Moonraker-Timelapse capture and playback.
Klipper LEDs, output pins, WLED, led_effects and macros, each able to change with the printer state.
These palettes come from the app's own theme files, so picking one here shows how it looks on the printer. This page is using one now.
I started this because my Adventurer 5M Pro couldn't show me its bed mesh. This is the view I wanted.
RAM figures are resident set size, measured on a FlashForge Adventurer 5M Pro, not install size.
| Feature | HelixScreen | KlipperScreen | GuppyScreen |
|---|---|---|---|
| Multi-material backends | 7 | 1 | 1 |
| RAM, armv7 | ~15 MB | ~50 MB | ~15-20 MB |
| Needs X11 or a browser | no | yes | no |
| Bed mesh in 3D, rotatable | yes | flat heatmap | flat heatmap |
| Input shaper graphs on-device | yes | no | no |
| Ultrawide and portrait screens | supported | no | no |
93 models in the auto-detection database, spanning Voron, Creality, QIDI, Anycubic, FlashForge, Sovol, RatRig, FLSUN, Elegoo, Prusa and Snapmaker. Printers outside the list work too if they run Klipper and Moonraker; the setup wizard detects their hardware.
800×480 and 1024×600 are the best-tested landscape sizes. 480×320 works with a tighter layout.See the full list.
Most of HelixScreen's features started as someone's request. Use whichever of these fits; they all reach me.
Something is broken
Include your printer model and the log file.
No GitHub account? Mail bugs@helixscreen.org instead.
I want it to do something it doesn't
Requests are public, so others can add to them.
I have a question, or want to talk it through
Usually the fastest way to get an answer.
I want to contribute code
Translation fixes, bug fixes and new features are all welcome.
Anything else
Reaches me directly.
Security issues go to security@helixscreen.org instead.
