Klippain Shake&Tune Resonance Analysis Plugin

Klippain Shake&Tune is a Klipper resonance analysis and input shaping calibration plugin that generates visual charts from accelerometer vibration data, helping to diagnose mechanical issues and optimize Input Shaper filters.

Enabling Configuration

FlyOS-Fast v1.3.5 and above comes with Shake&Tune pre-installed, requiring no manual installation. Add the following configuration section to printer.cfg to enable it:

[shaketune]
# result_folder: ~/printer_data/config/ShakeTune_results
#    Path where processing results are saved; the folder is created automatically if it does not exist
# number_of_results_to_keep: 10
#    Number of recent results to retain; older files are automatically cleaned up when exceeded
# keep_raw_data: False
#    Set to True to also save the raw .stdata files, useful for troubleshooting or submitting feedback
# show_macros_in_webui: True
#    Display Shake&Tune macro buttons in the Fluidd / Mainsail web interface
# timeout: 600
#    Chart generation timeout (seconds); can be increased on low-performance devices

After adding it, click Save & Restart in the web interface.

Available Macro Commands

Prerequisites

Before using Shake&Tune, confirm the following:

1. An accelerometer (ADXL345, LIS2DW, etc.) is installed and correctly configured, and ACCELEROMETER_QUERY returns data properly.
2. The [resonance_tester] section is defined in printer.cfg.
3. The printer has been homed.

The following macro commands can be used from the web console or in G-code:

Macro Command	Purpose
TEST_RESONANCES AXIS=X	Measure X-axis resonance and generate spectrum charts along with suggested Input Shaper parameters
TEST_RESONANCES AXIS=Y	Measure Y-axis resonance and generate spectrum charts
TEST_RESONANCES AXIS=X OUTPUT=raw_data	Only collect raw data without automatically generating charts
COMPARE_RESONANCES	Compare the last two resonance measurements, useful for observing the effect of adjustments
BELTS_SHAPER_TUNING	Dedicated belt resonance test, generating spectrum comparison charts with Hanning windows

After each execution, Shake&Tune generates PNG chart files in the result_folder, which can be viewed directly through the Fluidd / Mainsail file manager.

Accelerometer configuration and testing: View accelerometer testing and calibration

Resonance compensation and Input Shaper tuning: View resonance compensation and pressure advance configuration issues

General installation instructions: View DebugDoc plugins and extensions