Table of Contents

printer.cfg File

The printer.cfg file is where Klipper stores its permanent configuration settings for the printer. It is described in the Klipper documentation, the Configuration Reference for the file.

It's composed of sections, or stanzas, denoted like “[MyStanza]”, that group resource settings for that stanza in the following lines until the beginning of the next stanza. Configuration variable names are unique to the stanza and case insensitive. So think of the z_offset in the [Probe] stanza as being probe.z_offset whole the z_offset in the [head2] stanza would be head2.z_offset, an entirely different z offset value describing some other z offset delta. Since the file is read in linear sequence, the last value that might be repeated is the value that remains set.

Klipper Managed Settings

Klipper can and will automatically manage some settings for you. These will be stored in a semi-commented format at the bottom of the file and leverage that the last setting is what's set.

Example:

#*# <---------------------- SAVE_CONFIG ---------------------->
#*# DO NOT EDIT THIS BLOCK OR BELOW. The contents are auto-generated.
#*#
#*# [bed_mesh zero11]
#*# version = 1
#*# points =
#*# 	0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
#*# 	0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
#*# 	0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
#*# 	0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
#*# 	0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
#*# 	0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
#*# 	0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
#*# 	0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
#*# 	0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
#*# 	0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
#*# 	0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
#*# tension = 0.2
#*# min_x = 10.0
#*# algo = bicubic
#*# y_count = 11
#*# mesh_y_pps = 4
#*# min_y = 21.0
#*# x_count = 11
#*# max_y = 211.0
#*# mesh_x_pps = 4
#*# max_x = 210.0

Things Not Stored In printer.cfg

Examples of printer.cfg files

https://github.com/Klipper3d/klipper/tree/master/config