prestonbrown / helixscreen
A modern, lightweight touchscreen interface for Klipper 3D printers
View on GitHubAI Architecture Analysis
This repository is indexed by RepoMind. By analyzing prestonbrown/helixscreen in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Repository Overview (README excerpt)
Crawler viewHelixScreen A modern touch interface for Klipper/Moonraker 3D printers helixscreen.org Your printer can do way more than your current touchscreen lets you. Bed mesh visualization, input shaper graphs, multi-material management, print history — it's all trapped in a browser tab. HelixScreen puts it at your fingertips. Fast, beautiful, and built for every Klipper printer — from a Creality K1 to a tricked-out Voron or RatRig. --- > **Release Candidate — v0.98** > > Approaching 1.0 with a customizable grid dashboard, full widget system, and comprehensive printer support. Looking for testers across different printer setups. > > **Tested on:** Voron 2.4 (Raspberry Pi 5), Voron 0.2, Doron Velta, RatRig V-Core, Flashforge AD5M Pro (Forge-X firmware), QIDI Q1 Pro, Sovol SV06, Sovol SV08 > > **Raspberry Pi:** Both 64-bit and 32-bit Raspberry Pi OS are supported (Pi 4, Pi 5, CM4, Zero 2 W). > > **QIDI:** Supported with auto-detection heuristics and print start profile. > > **Flashforge:** AD5M/Pro (Forge-X firmware), AD5X (ZMOD firmware). > > **Creality:** Sonic Pad, K1/K1C/K1 Max binaries are included. K2 Plus build target exists (ARM, static musl) but is **untested** — if you have one, we'd love your help! > > **Snapmaker U1:** Cross-compile target with 480x320 display support. > > **Ready to help?** See Installation. Found a bug? Open an issue. Have an idea? Request a feature. Want to chat? Join our Discord. --- **Quick Links:** Website · Features · Screenshots · Installation · User Guide · FAQ · Contributing · Changelog · Discord --- Why HelixScreen? • **Customizable dashboard** — Drag, resize, and arrange widgets on a grid that persists across restarts • **Every feature at your fingertips** — 30+ panels, 18 overlays, 13 modals, 233 XML layouts • **Runs on anything** — ~10MB RAM, from a Creality K1 to a Raspberry Pi 5 • **68 printers in the database** — Auto-detects your hardware and configures itself • **Multi-material ready** — AFC, Happy Hare, ValgACE, ViViD, tool changers, Spoolman • **Looks great** — Light/dark themes with 14 presets, responsive layouts, GPU-accelerated blur • **First-run wizard** — 13-step guided setup discovers your printer's capabilities Technical comparison | Feature | HelixScreen | GuppyScreen | KlipperScreen | |---------|-------------|-------------|---------------| | UI Framework | LVGL 9 XML | LVGL 8 C | GTK 3 (Python) | | Declarative UI | Full XML with reactive bindings | C only | Python only | | RAM Usage | ~10MB | ~15-20MB | ~50MB | | Disk Size | ~70-80MB | ~60-80MB | ~50MB | | Multi-Material | 5 backends | Limited | Basic | | Printer Database | 68 models | — | Manual config | | Display Layouts | Auto-detecting (tiny to ultrawide) | Fixed | Configurable | | Status | Release Candidate (active) | Inactive | Mature (maintenance) | | Language | C++17 | C | Python 3 | Screenshots Home Panel Print File Browser Bed Mesh Visualization More screenshots Controls Panel Motion Controls AMS / Filament Management Input Shaper Results PID Tuning Settings First-Run Wizard See docs/devel/GALLERY.md for the full gallery. Features **Dashboard** — Customizable grid layout with drag-to-reposition, edge resize, widget catalog, per-breakpoint persistence. Includes clock, job queue, shutdown/reboot, temperature, fan, network, power, and more. **Printer Control** — Print management with G-code preview, motion controls, temperature presets with per-material overrides, multi-fan control, Z-offset, speed/flow tuning, live filament consumption tracking, power device management **Multi-Material** — 5 filament system backends: AFC (Box Turtle), Happy Hare (ERCF, 3MS, Tradrack), ValgACE, ViViD, and tool changers. Multi-unit and multi-backend support. Full Spoolman integration with spool creation wizard. **Visualization** — 3D G-code layer preview with memory-aware geometry budgets, 3D bed mesh with async rendering, print thumbnails, frequency response charts, unified temperature graph **Calibration** — Input shaper with frequency response charts, PID tuning with live graph, MPC calibration (Kalico), bed mesh, screws tilt adjust, Z-offset, firmware retraction, probe management **Integrations** — HelixPrint plugin, power devices with quick-toggle, print history with dashboard, timelapse (Moonraker plugin), exclude objects with per-object thumbnails, LED control (5 backends), sound alerts (SDL/PWM/M300) **Display** — Auto-detecting layout system (480x320, 800x480, 1024x600, 1920x480 ultrawide), display rotation (0/90/180/270) with auto-detection, light/dark themes with 14 presets and live theme editor, GPU-accelerated backdrop blur, screensavers **System** — 13-step first-run wizard, 68 printer models with auto-detection, opt-in crash reporting with debug bundles, KIAUH installer, versioned config migration, i18n translation system Supported Platforms | Platform | Architecture | Status | |----------|-------------|--------| | Raspberry Pi 4/5 (64-bit) | aarch64 | Tested | | Raspberry Pi (32-bit) | armhf | Tested | | BTT Pad / CB1 / Manta | aarch64 | Supported | | Flashforge AD5M/Pro | armv7-a | Tested | | Flashforge AD5X | MIPS32 | Supported | | QIDI (Q1 Pro, Plus 4, etc.) | aarch64 | Supported | | Creality Sonic Pad | armhf | Tested | | Creality K1/K1C/K1 Max | MIPS32 | Builds available | | Creality K2 Plus | ARM (musl) | Untested | | Sovol SV06/SV08 | Pi build | Active testing | | Elegoo Centauri Carbon | Dedicated build | Active testing | | Snapmaker U1 | armv7-a | Cross-compile target | | macOS | x86_64/ARM64 | Development | | Linux | x86_64 | Development / CI | Installation > **Run these commands on your printer's host computer, not your local machine.** > > SSH into your Raspberry Pi, BTT CB1/Manta, or similar host. For all-in-one printers (Creality K1, K2 series, Flashforge AD5M/Pro), SSH directly into the printer itself. **One-line install (Raspberry Pi, Creality, QIDI, Sovol, and more):** The installer auto-detects your platform, downloads the corr…