Ghosting and ringing - the faint echoes and ripples that appear on vertical surfaces after a sharp corner - are caused by vibration in the printer frame. Input shaper (also called resonance compensation) measures those vibrations and filters them out in the motion system. This guide explains what it is, how to set it up, and what to expect.
When a print head changes direction quickly, the frame vibrates slightly from the sudden force. Those vibrations travel through the print head and leave visible artefacts on the print surface - wavy lines parallel to corners, faint echoes of features, or a general soft look on what should be sharp edges.
Input shaper works by measuring the natural resonant frequency of your printer's X and Y axes, then actively counteracting vibrations at those frequencies in the motion planning. The result is sharper corners, cleaner surfaces, and the ability to print faster without artefacts appearing.
Input shaper is a firmware feature, available on:
If your printer runs stock Creality firmware, input shaper is not available without a firmware change or upgrade to Klipper.
Input shaper fixes vibration-caused artefacts. It will not fix:
If you have ghosting or ringing, check and tighten belts before anything else. Input shaper on top of loose belts will not fully resolve the problem.
Klipper's input shaper is the most powerful and widely used implementation. There are two ways to measure resonant frequencies: with an accelerometer, or manually.
This is the accurate method. An ADXL345 accelerometer module mounts to the print head and measures actual vibration frequencies while the printer runs a test pattern.
Setup steps:
TESTRESONANCES AXIS=X then TESTRESONANCES AXIS=YSHAPER_CALIBRATE to automatically pick the best shaper type and frequencySAVE_CONFIGThe whole process takes about 20 minutes once the accelerometer is wired. The result is precise, automatic calibration rather than a manual guess.
If you do not have an accelerometer, you can tune input shaper manually by printing ringing test models and adjusting settings by eye.
[input_shaper] sectionshaper_type: mzv as a starting point (MZV is a good general-purpose shaper)shaperfreqx and shaperfreqy to an initial estimate (typically 30 - 60Hz for most printers)Manual tuning takes longer and is less precise than accelerometer calibration, but it works and costs nothing extra.
Bambu handles this automatically. The process is:
Re-run this calibration if you:
Prusa's built-in input shaper calibration is accessible from the printer's menu:
Re-run after belt replacements or significant printer moves.
After input shaper is calibrated and enabled:
Print quality: Ghosting and ringing on vertical surfaces should be significantly reduced or eliminated. Corners should be sharper and cleaner.
Print speed: Input shaper allows higher acceleration settings without introducing artefacts. You can often increase acceleration by 2 - 4x compared to pre-input-shaper settings while maintaining the same print quality. This means faster prints without quality loss.
The trade-off: Some input shaper algorithms (particularly EI and 2HUMP_EI) can slightly reduce maximum extrusion speed at high accelerations. MZV is the safest starting point - good vibration suppression with minimal speed impact.
| Shaper | Best For | Trade-off |
|---|---|---|
| MZV | Most printers, good all-rounder | Moderate vibration reduction |
| EI | Printers with higher resonance frequencies | Can limit max speed slightly |
| 2HUMP_EI | Printers with very broad resonance peaks | Reduces max speed more |
| ZV | Very simple, least reduction | Only for very rigid frames |
Start with MZV unless the automatic calibration recommends otherwise.
Do I need to recalibrate if I change filament? No. Input shaper is about the printer's mechanical properties, not the filament.
Will input shaper fix layer shifting? No. Layer shifting is caused by belts, grub screws, or overheating drivers - not vibration. Input shaper only addresses print surface artefacts.
Can I run input shaper on an Ender 3 without Klipper? Not effectively on stock firmware. You would need to install Klipper or a third-party firmware that supports it.
Does input shaper wear out? No, but calibration can drift if mechanical components change. Re-run calibration after any maintenance that affects the motion system.