Steps per mm calculator

Work out the correct steps/mm for belt or lead-screw axes, with the matching Marlin command and Klipper rotation_distance.

Never uploadedBelt & lead screw1.8° / 0.9° motorsMarlin & KlipperMicrostepping

Loading tool…
3dfiles Pro: big files, STEP export, batches.Pro adds files over 100 MB, unlimited STEP export, fit-to-printer cuts, colour 3MF and big batches. Free for 7 days, or a one-off 7-day pass.
See Pro

The formulas

Belt axis: steps/mm = (motor steps per revolution × microstepping) ÷ (belt pitch × pulley teeth).
Lead screw: steps/mm = (motor steps per revolution × microstepping) ÷ screw lead.

Common values (1.8° motor, 16× microstepping)

Drivesteps/mmKlipper rotation_distance
GT2 belt, 20-tooth pulley8040
GT2 belt, 16-tooth pulley10032
T8 lead screw, 8 mm lead4008
T8 lead screw, 2 mm lead16002

A "T8" screw with 8 mm lead has four starts and a 2 mm pitch – lead (travel per revolution) is what counts, not pitch.

Microstepping and accuracy

Higher microstepping makes motion smoother and quieter, but does not make each step proportionally more accurate. 16× (often interpolated to 256× by the driver) is the common choice for printers.

Common questions

Where do I find the belt pitch?

Nearly all hobby printers use GT2 belts with 2 mm pitch. GT3 is 3 mm, HTD-3M 3 mm.

Klipper asks for rotation_distance, not steps/mm

rotation_distance is the travel per full motor revolution: belt pitch × pulley teeth, or the screw lead. The calculator shows both.