Welcome to the Danger Klipper project!

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.

Features merged into the master branch:

• core: no Python2 tests; no PRU boards

• core: git-untracked folder, plugins for user-plugins

• core: danger_options

• core: rotate log file at every restart

• fan: normalising Fan PWM power (klipper#6307)

• fan: reverse FAN (klipper#4983)

• heater: modify PID without reload

• heater: velocity PID (klipper#6272)

• heater: PID-Profiles

• heater: expose heater thermistor out of min/max

• gcode: jinja2.ext.do extension (klipper#5149)

• gcode: gcode_shell_command (klipper#2173 / kiuah )

• gcode: expose math functions to gcode macros (klipper#4072)

• gcode: HEATER_INTERRUPT gcode command

• probe: dockable Probe (klipper#4328)

• probe: drop the first result (klipper#3397)

• probe: z_calibration (klipper#4614 / protoloft/z_calibration)

• z_tilt: z-tilt calibration (klipper3d#4083 / dk/ztilt_calibration)

• stepper: home_current

• stepper: current_change_dwell_time

• homing: post-home retract

• homing: sensorless minimum home distance

• homing: min_home_dist

• virtual_sdcard: scanning of subdirectories (klipper#6327)

• retraction: z_hop while retracting (klipper#6311)

• 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

• danger_options: option to ignore ADC out of range

• temperature_mcu: add reference_voltage (klipper#5713)

• adxl345: improve ACCELEROMETER_QUERY command

• extruder: add flag to use the PA constant from a trapq move vs a cached value

• force_move: turn on by default

• bed_mesh: add bed_mesh_default config option

• config: CONFIG_SAVE updates included files

• kinematics: independent X & Y acceleration and velocity settings

• idle_timeout: allow the idle timeout to be disabled

• canbus: custom CAN bus uuid hash for deterministic uuids

• filament_switch|motion_sensor: runout distance, smart and runout gcode

• save_config: save without restarting the firmware

• configfile: recursive globs / (klipper#6375)

If you're feeling adventurous, take a peek at the extra features in the bleeding-edge branch feature documentation and feature configuration reference:

• dmbutyugin's advanced-features branch - Pull Request #69
  • 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

Switch to Danger Klipper

Note

Any add-on modules you are using will need to be reinstalled after switching to Danger Klipper. This includes things like Beacon support, led-effect, etc.

Any data in ~/printer_data such as printer configs and macros will be unaffected.

Manually clone the repository

If desired, make a backup copy of your existing Klipper installation by running:

mv ~/klipper ~/klipper_old

Then clone the Danger Klipper repo and restart the klipper service:

git clone https://github.com/DangerKlippers/danger-klipper.git ~/klipper
sudo systemctl restart klipper

Using KIAUH

For users that are not comfortable using Git directly, KIAUH is able to use custom repositories.

To do this, add the Danger Klipper repo to KIAUH's repo list and run the script with the following commands:

echo "DangerKlippers/danger-klipper" >> ~/kiauh/klipper_repos.txt
~/kiauh/kiauh.sh

From the KIAUH menu select:

• 6 ) Settings
• 1 ) Set custom Klipper repository
• Select the number corresponding to DangerKlipper from the list shown
• Select 'Y' to confirm replacing your existing Klipper install
• Enter 'B' for back twice
• 'Q' to quit

Adding a git-remote to the existing installation

cd ~/klipper
git remote add danger https://github.com/DangerKlippers/danger-klipper.git
git checkout -b upstream-master origin/master
git branch -D master
git checkout -b master danger/master
sudo systemctl restart klipper
sudo systemctl restart moonraker

---

"Dangerous Klipper for dangerous users"

Klipper 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 Klipper.

To begin using Klipper start by installing it.

Klipper is Free Software. See the license or read the documentation.