Klipper Shake&Tune plugin

This is a dedicated port of the Klippain Shake&Tune v5.1.1 module for installation on the Qidi Plus4 3D Printer

Shake&Tune is a Klipper plugin from the Klippain ecosystem, designed to create insightful visualizations to help you troubleshoot your mechanical problems and give you tools to better calibrate the input shaper filters on your 3D printer. It can be installed on any Klipper machine and is not limited to those using the full Klippain.

Check out the detailed documentation here.

Installation

Follow these steps to install Shake&Tune on your printer:

1. Important Update 15th July 2025

   Debian Buster has recently moved its repositories. Run the following command from the printer's SSH command shell to fix up the printer's repo references:

   sudo sed -i -e '/security\.debian\.org/ s/^deb/#deb/g' -e 's!deb\ http\:\/\/deb\.!deb\ http\:\/\/archive\.!' /etc/apt/sources.list
   

2. Very Important:

   If you have an automated update section named [update_manager Klippain-ShakeTune] in your moonraker.cfg file, please delete it before proceeding

3. Install Shake&Tune on your Plus4 by running over SSH on your printer:

   BE AWARE THAT THE FOLLOWING WILL RESTART YOUR PRINTER FIRMWARE.

   ENSURE YOU DO NOT HAVE AN ACTIVE PRINT JOB RUNNING BEFORE PROCEEDING

   cd /home/mks
   git clone https://github.com/qidi-community/klippain_v511_for_qidi_plus4.git
   cd klippain_v511_for_qidi_plus4
   ./install.sh
   
   

4. Then, insert the following into your printer.cfg file BEFORE the SAVE_CONFIG section and restart Klipper:

   [shaketune]
   # result_folder: ~/printer_data/config/ShakeTune_results
   #    Path where the processed results will be stored. If the folder doesn't exist,
   #    it will be automatically created. You can change this if you'd like to store 
   #    results in a different location.
   # number_of_results_to_keep: 10
   #    This setting defines how many results you want to keep in the result folder.
   #    Once the specified number is exceeded, older results will be automatically deleted
   #    to free up space on the SD card and avoid cluttering the results folder.
   # keep_raw_data: False
   #    If set to True, Shake&Tune will store both the processed graphs and the raw accelerometer
   #    .stdata files in the results folder. This can be useful for debugging or archiving purposes.
   #    Please always attach them when reporting any issues on GitHub or Discord.
   # show_macros_in_webui: True
   #    Mainsail and Fluidd doesn't create buttons for system commands (macros that are not part
   #    of the printer.cfg file). This option allow Shake&Tune to inject them into the webui at runtime.
   #    If set to False, the macros will be hidden but still accessible from the console by typing
   #    their names manually, which can be useful if you prefer to encapsulate them into your own macros.
   # timeout: 600
   #    This defines the maximum processing time (in seconds) to allows to Shake&Tune for generating 
   #    graphs from a .stdata file. 10 minutes should be more than enough in most cases, but if you have
   #    slower hardware (e.g., older SD cards or low-performance devices), increase it to prevent timeouts.
   # measurements_chunk_size: 2
   #    Each Shake&Tune command uses the accelerometer to take multiple measurements. By default,
   #    Shake&Tune will write a chunk of data to disk every two measurements, and at the end of the
   #    command will merge these chunks into the final .stdata file for processing. "2" is a very
   #    conservative setting to avoid Klipper Timer Too Close errors on lower end devices with little
   #    RAM, and should work for everyone. However, if you are using a powerful computer, you may
   #    wish to increase this value to keep more measurements in memory (e.g., 15-20) before writing
   #    the chunk and avoid stressing the filesystem too much.
   # max_freq: 200
   #    This setting defines the maximum frequency at which the calculation of the power spectral density
   #    is cutoff. The default value should be fine for most machines and accelerometer combinations and
   #    avoid touching it unless you know what you're doing.
   # dpi: 300
   #    Controls the resolution of the generated graphs. The default value of 300 dpi was optimized
   #    and strikes a balance between performance and readability, ensuring that graphs are clear
   #    without using too much RAM to generate them. Usually, you shouldn't need to change this value.
   

Documentation

Don't forget to check out Shake&Tune documentation here.

Acknowledgement

This repository is a fork modified and tailored for the Qidi Plus 4 3D Printer.

It should be noted that all of Klippain-Shaketune is authored by Félix Boisselier felix@fboisselier.fr

All acknowledgement and respect to Félix for his excellent work!