What is this about?

Calibrating Input Shaping helps reduce vibration artifacts (ringing/ghosting) and improves print quality, especially at higher speeds.

⚠️ Quick Context: Input Shaping compensates for mechanical resonances in your printer. This step measures your printer's vibrations and applies software corrections to eliminate ringing and ghosting in your prints. It takes about 10 minutes and should be done after Z-offset calibration.

---

What are we doing now?

In this step you let the printer measure its own mechanical resonances (the timing belts acts like springs) so that klipper can apply the right Input Shaping parameters for your X and Y axes. Once done, these settings are stored in your configuration and automatically used for all future prints.

Time required: ~10 minutes

---

Prerequisites

• Bed leveling completed
• Z-offset calibration completed
• Printer ready

---

Methods to Perform Input Shaping Calibration

There are three ways to run Input Shaping calibration. All methods perform the same calibration - they only differ in how you start it.

---

Method 1: Using the Display Menu (Recommended)

This is the easiest method for most users.

1. On the printer display, go to: Gear Icon → Advanced → Next Page → Input Shaping

   

2. The printer will home and then perform the Input Shaping calibration

   • You'll hear the printer making rapid back-and-forth movements
   • This is normal – it's measuring vibrations at different frequencies

3. Please wait until the process is finished

   • Note: Currently there is no visual "finished" message on the display
   • The calibration takes about 5-10 minutes
   • You'll know it's done when the printer stops moving and returns to idle

4. Once calibration is complete, the measured shaper settings for the X and Y axes are automatically saved to your printer.cfg

The settings will look similar to this:

---

Method 2: Using the Console in Mainsail

If you prefer using commands:

1. Open the Console in Mainsail

2. Enter the following command:

   ---

   INPUT_SHAPING_CALIBRATE

   ---

3. The printer will home and run through the motion pattern needed to measure resonances

4. Wait for the calibration to complete (5-10 minutes)

5. The settings are automatically saved to your printer.cfg

---

Method 3: Using a Macro in Mainsail

You can also start the Input Shaping calibration using a macro button in Mainsail:

1. Click the INPUT SHAPING CALIBRATE macro button

2. The process is the same as Method 2

---

What Happens During Calibration?

During Input Shaping calibration:

1. The printer homes all axes
2. The toolhead moves to the center of your printbed and then moves rapidly back and forth along the X-axis at different frequencies
3. When done, it does the same for the Y-axis
4. The accelerometer measures vibrations during these movements
5. Klipper calculates the best Input Shaping parameters based on the measured data
6. The results are saved to the auto-generated section at the end of printer.cfg

This is normal: The printer will make buzzing/humming sounds and move very quickly. Don't worry – this is intentional.

---

Verification

After calibration:

1. Open Mainsail and navigate to Configuration → printer.cfg
2. Scroll to the bottom of the file
3. You should see a section like this:

#*# <---------------------- SAVE_CONFIG ---------------------->
#*# DO NOT EDIT THIS BLOCK OR BELOW. The contents are auto-generated.
#*#
#*# [input_shaper]
#*# shaper_type_x = mzv
#*# shaper_freq_x = 54.2
#*# shaper_type_y = ei
#*# shaper_freq_y = 42.8

Good values:

• Shaper frequencies typically range from 30-80 Hz
• Shaper types are usually: mzv, ei, 2hump_ei, or 3hump_ei

If you see these values, your calibration was successful!

---

Troubleshooting

The printer is too loud during calibration

Solution: This is normal. Input Shaping calibration requires rapid movements to measure resonances. The noise should only last 5-10 minutes.

Should I recalibrate after every print?

Solution: No! Input Shaping calibration only needs to be done once (or after significant mechanical changes like tightening belts, changing the frame, or moving the printer).

---

When to Recalibrate

You should recalibrate Input Shaping if:

• You make mechanical changes (tighten belts, adjust frame, change toolhead)
• You notice ringing/ghosting returning in your prints
• You upgrade or replace major components

Otherwise, the calibration remains valid indefinitely.

---

By following one of these methods, you can successfully calibrate Input Shaping for your printer, improving overall print quality and reducing artifacts caused by vibrations.

---

Next Step: Nozzle PID Tuning →