Repository navigation
v4.4.0-beta.1
Pre-releaseKlippain v4.4.0-beta.1
Testing & reporting issues
This is a beta release. If something breaks:
- Open a GitHub issue with your printer config, the feature/macro involved, and
steps to reproduce. - Include the relevant
klippy.logerrors if applicable.
Upgrade notes
Klippain never overwrites your variables.cfg, printer.cfg, or overrides.cfg on
update. The changes below only affect you if you haven't already set the variable in
question yourself.
⚠️ Retract/unretract length defaults changed
Start/end print and prime-line retract moved from hardcoded values to configurable
variables, with new defaults:
| Variable | Old hardcoded value | New default |
|---|---|---|
retract_length |
10mm | 20mm |
unretract_length |
18mm | 23mm |
If you've never set variable_retract_length / variable_unretract_length in your
variables.cfg, your printer will now retract/unretract roughly twice as much
filament at print start/end and on cancel. To keep your previous behavior, add both
variables to your variables.cfg with the old values (10 / 18).
minimum_cruise_ratio ships commented out
Klippain's kinematics configs now include Klipper's minimum_cruise_ratio
parameter, but it's commented out by default so older Klipper installs aren't
affected. If you're on a reasonably current Klipper, uncomment it via an override.
New-install default for prime line wipe flipped to off
Fresh installs now default to variable_prime_line_wipe: False (previously
True). This only affects new installs — if you're updating, your existing
variables.cfg value is untouched.
MMU_EJECT renamed to MMU_UNLOAD
If you have custom macros or slicer profiles calling MMU_EJECT directly, switch to
MMU_UNLOAD. Under Happy Hare v2 the two commands behaved identically; this rename
anticipates Happy Hare v3, where eject and unload diverge for "Type B" MMUs.
Highlights
- Beacon contact & Cartographer Survey Touch support, unified under a new
virtual Z-probe capability framework — see
docs/features/virtual_z_probes.md. - Dynamic START_PRINT / END_PRINT hooks — register custom
_START_PRINT_ACTION_<NAME>/_END_PRINT_ACTION_<NAME>macros instead of
editing core files. See docs/overrides.md. - AWD (dual X + dual Y motor) support.
- ~15 new board templates, including Fysetc SB Combo V2, Orbitool, Mellow FLY
D5 / ERCF v2 / SB2040-PRO-V3 / Gemini v3, BTT EBB SB2209 USB, BTT EBB GEN2, BTT
Manta E3EZ, and Fystec Cheetah v3 — pick them from the installer's MCU template
menu. - Pause behavior controls — auto idle-timeout on pause, hotend-off on pause,
and pause at (next) layer. - BTT TMC5160 sensorless homing.
Full list of changes: CHANGELOG.md