This is a community-maintained fork of the Klipper firmware.
Our goal is to support features and behavior that could be "risky" if used incorrectly.
If I want my printer to light itself on fire, I should be able to make my printer light itself on fire.
See the Kalico Additions document for more information on some of the differences from Klipper.
-
core: options for API server socket file mode, user, and group
-
core: options to change mode and group of linux mcu psuedoterminal
-
probe: z_calibration (klipper#4614 / protoloft/z_calibration)
-
z_tilt: z-tilt calibration (klipper3d#4083 / dk/ztilt_calibration)
-
danger_options: allow plugins to override conflicting extras
-
danger_options: expose the multi mcu homing timeout as a parameter
-
danger_options: option to configure the homing elapsed distance tolerance
-
extruder: add flag to use the PA constant from a trapq move vs a cached value
-
resonance_tester: warn about active fans during input shaper calibration
-
kinematics: independent X&Y accel/velocity for corexy and cartesian
-
filament_switch|motion_sensor: runout distance, smart and runout gcode
-
z_tilt|qgl: custom threshold for probe_points_increasing check
If you're feeling adventurous, take a peek at the extra features in the bleeding-edge-v2 branch feature documentation and feature configuration reference:
-
extruder/pa: do not smooth base extruder position, only advance
-
dmbutyugin's advanced-features branch - Pull Request #262
- stepper: high precision stepping protocol
- extruder: sync extruder motion with input shaper
- extruder: new print_pa_tower utility
- input_shaper: smooth input shapers
- input_shaper: new print_ringing_tower utility
Note
Any add-on modules you are using will need to be reinstalled after switching to Kalico. This includes things like Beacon support, led-effect, etc.
Any data in ~/printer_data such as printer configs and macros will be unaffected.
If desired, make a backup copy of your existing Klipper installation by running:
mv ~/klipper ~/klipper_oldThen clone the Kalico repository and restart the klipper service:
git clone https://github.com/KalicoCrew/kalico.git ~/klipper
sudo systemctl restart klipperIt might happen that your python environment needs to be updated. If that is the case, run:
~/klippy-env/bin/pip install -r ~/klipper/scripts/klippy-requirements.txtFor users that are not comfortable using Git directly, KIAUH v6 is able to use custom repositories.
To do this, add the Kalico repo to KIAUH's custom repository config depending on your KIAUH version:
-
cd ~/kiauh -
cp default.kiauh.cfg kiauh.cfg -
nano kiauh.cfg -
add
https://github.com/KalicoCrew/kalico, mainfor the main branchor
https://github.com/KalicoCrew/kalico, bleeding-edge-v2for the bleeding edge branch -
CTRL-X to save and exit
From the KIAUH menu select:
-
[S] Settings
-
1) Switch Klipper source repository
-
Select Kalico from the list
-
Add the custom repository to your
klipper_repos.txtin the~kiauhdirectory -
echo "https://github.com/KalicoCrew/kalico,main" >> ~/kiauh/klipper_repos.txtfor the main branchor
echo "https://github.com/KalicoCrew/kalico,bleeding-edge-v2" >> ~/kiauh/klipper_repos.txtfor the bleeding edge branch
From the KIAUH menu select:
-
[6] Settings
-
1) Set custom Klipper repository
-
Select Kalico from the list
Repository changes will not persist across KIAUH versions.
It allows you to switch back to mainline Klipper at any time via a git checkout upstream_main
cd ~/klipper
git remote add kalico https://github.com/KalicoCrew/kalico.git
git fetch kalico
git checkout -b upstream-main origin/master
git branch -D master
git checkout -b main kalico/main
sudo systemctl restart klipper
sudo systemctl restart moonrakerKalico is a 3d-Printer firmware. It combines the power of a general purpose computer with one or more micro-controllers. See the features document for more information on why you should use Kalico.
To begin using Kalico start by installing it.
Kalico is Free Software. See the license or read the documentation.
