How protorayn/klipperscreen-happy-hare-edition works
KlipperScreen Happy Hare Edition is a touchscreen interface for Klipper printers, extended to operate and monitor Happy Hare multi-material units (MMUs). The main user workflow is to open a printer panel, view live printer or MMU state, and issue controls through Moonraker; the screen also handles incoming notifications and updates. Major product areas include ordinary printer controls, MMU gate and filament management, spool tracking, and network settings. The graph reflects README capabilities and the supplied source index; several panel-specific connections are left unverified because their implementations were not excerpted.
Main entry points: screen.py Screen controller · mmu_mixin.py MMU shared logic · mmu_main.py MMU operations · MoonrakerApi.py Moonraker API
Components 26
Screen runtime
- Screen controller
screen.py - Configuration
ks_includes/config.py - GTK toolkit
ks_includes/KlippyGtk.py - Notification router
ks_includes/notification_handler.py - On-screen keyboard
ks_includes/widgets/keyboard.py
Printer integration
- Printer state
ks_includes/printer.py - Moonraker API
ks_includes/MoonrakerApi.py - WebSocket transport
ks_includes/KlippyWebsocket.py - REST client
ks_includes/KlippyRest.py - Moonraker service
- NetworkManager access
ks_includes/sdbus_nm.py - Spoolman API
ks_includes/spoolman_api.py
Printer controls
- Shared panel base
panels/base_panel.py - Temperature controls
panels/temperature.py - Heater graph
ks_includes/widgets/heatergraph.py - Print job status
panels/job_status.py - G-code browser
panels/gcodes.py - Network settings
panels/network.py
Happy Hare MMU
- MMU operations
panels/mmu_main.py - MMU gauges
panels/mmu_gauges.py - MMU shared logic
panels/mmu_mixin.py - Gate filaments
panels/mmu_filaments.py - MMU management
panels/mmu_manage.py - Tool mapping
panels/mmu_toolmap.py - Spool tracking
panels/spoolman.py
Other components
- Touchscreen user
Connections 24
- Touchscreen user → Screen controller: operates
README.md - Screen controller → Configuration: loads settings
screen.py - Screen controller → GTK toolkit: builds interface
screen.py - Screen controller → Printer state: maintains state
screen.py - Screen controller → Notification router: routes events
screen.py - Screen controller → On-screen keyboard: shows input
screen.py - Screen controller → Shared panel base: attaches panels
screen.py - Moonraker API → WebSocket transport: sends methods
ks_includes/MoonrakerApi.py - Moonraker service → WebSocket transport: exchanges messages
- Screen controller → Moonraker API: uses API
- Screen controller → REST client: uses REST
screen.py - Temperature controls → Heater graph: renders graph
panels/temperature.py - Network settings → NetworkManager access: manages connections
panels/network.py - MMU operations → MMU shared logic: uses shared logic
panels/mmu_main.py - MMU operations → MMU gauges: updates gauges
panels/mmu_main.py - Gate filaments → MMU shared logic: uses shared logic
panels/mmu_filaments.py - MMU management → MMU shared logic: uses shared logic
panels/mmu_manage.py - Tool mapping → MMU shared logic: uses shared logic
panels/mmu_toolmap.py - MMU shared logic → Spool tracking: uses spool data
panels/mmu_mixin.py - Spool tracking → Spoolman API: queries service
- Screen controller → MMU operations: opens MMU panel
- Screen controller → Temperature controls: opens printer panels
- Screen controller → Print job status: opens printer panels
- Screen controller → G-code browser: opens printer panels