Skip to content
EduFacturing

A draft printer.cfg and macros.cfg for your Klipper printer

Choose kinematics, size, board, drivers, extruder, probe and macros step by step, or start from one of 8 templates (for example the Voron 2.4 or an Ender 3 with a BTT board), and get a draft of printer.cfg and macros.cfg that you finish by hand.

Part of Pro, 15 EUR a month.

What a Klipper config and printer.cfg are

A Klipper config is the printer.cfg file where the Klipper firmware finds the axes, motors, heaters, probe and speeds of the printer. This generator, part of Pro, builds a draft of that file from your choices: printer, board, drivers, extruder, hotend and probe.

You choose step by step, and the app writes the sections, the board pins and the starting values. The result is a draft, not a finished file: before the first start you edit it by hand and check the pins, currents and rotation_distance.

Generation happens in your browser. A file reaches the EduFacturing server only if you save it to your account library.

Klipper config generator in English: eight printer templates on the left, a generated printer.cfg on the right
Klipper config generator in English: eight printer templates on the left, a generated printer.cfg on the right

What the Klipper config generator does

Builds printer.cfg from your choices

Start from one of 8 templates or choose kinematics, size, leveling, board, drivers, extruder, hotend, probe and filament sensor.

Builds macros.cfg

Macros for the start and end of a print (PRINT_START, PRINT_END, CANCEL_PRINT), parking, filament loading and unloading, M600 and PID tuning. You choose which go in.

Checks your choices

3 errors block the download (for example TMC5160 on an SKR Mini), 4 only warn (for example CoreXY without leveling). They do not check whether Klipper will accept the file.

Shows and uploads the files

A 3D preview of the print start at your size. In the Moonraker tab you enter the printer IP, upload both files and restart Klipper.

When you need a printer.cfg generator

The generator saves hours when you move to Klipper or build a printer.

  • Moving to Klipper

    An Ender 3 with a BTT SKR Mini and a BLTouch is a template: a starting printer.cfg in which you enter the board serial number and the BLTouch pin.

  • Building a Voron or a RatRig

    The Voron 2.4, Trident, RatRig V-Core 3 and VzBot 330 templates set kinematics, board, drivers and leveling; you add the extra Z motors.

  • Changing the probe or board

    Change a choice and watch the probe section and board pins change.

  • Wanting ready macros

    PRINT_START with homing, leveling (QGL or Z-tilt if chosen), a mesh only without QGL and Z-tilt and a purge line (LINE_PURGE from KAMP or its own).

What goes into printer.cfg and from where

Your choices decide the sections of the file. These are the rules and numbers in the code.

  1. The board gives the pins

    For 5 boards (Octopus, SKR Mini E3, Manta M8P, Fysetc Spider, SKR Pico) there is a pin table; Generic, SHT36 and EBB SB2209 get placeholders such as X_STEP.

  2. Your choice decides the sections

    The probe gives its section; leveling gives QGL, Z-tilt or a mesh; the TMC2209 and TMC5160 drivers give motor sections; sensorless homing gives a virtual endstop.

  3. The level changes the speed

    Strict sets 150 mm/s and 1500 mm/s²; Standard keeps the values by kinematics; Ludicrous goes up to 800 mm/s and 15000 mm/s². The labels up to 3k and up to 7k do not match.

The numbers in the file
Applies toFormulaMeaning
Speed by kinematics (Standard)Cartesian 250 mm/s and 2000 mm/s²; CoreXY 400 and 4000; CoreXZ 300 and 3000become max_velocity and max_accel
Leveling mesh5 × 5 points, 30 mm in from the edgesa bed_mesh section with no QGL or Z-tilt, if there is a probe or the printer is CoreXY

Reference

Supported MCU boards

ParameterValue
BTT SKR Mini E3built-in drivers (Ender-class)
BTT Octopus / Pro8 drivers, up to 60V
BTT Manta M8P/M4Pbuilt-in CB1/CM4 slot
Fysetc Spiderhigh power, for CoreXY
BTT EBB SB2209CAN head (Stealthburner)

The list of supported boards in the configurator

Key parameters in printer.cfg

ParameterValueUnit
max_velocitycartesian 250, corexy 400, delta 300mm/s
max_accelcartesian 2000, corexy 4000, delta 3000mm/s^2
microsteps16 standard, 32 for tmc5160/tmc2240
rotation_distance X/Y40mm
run_current TMC2209 X/Y0.8A

Values computed by printer type, driver and safety level

Checks and upload to the printer

  • Three errors block the download, four warn

    Three errors (for example TMC5160 on an SKR Mini) block the download; four warnings do not. None of the templates gets an error, yet Klipper may refuse them.

  • Files in the language of the screen

    Comments and display messages are in Bulgarian or English, as the screen is.

  • Upload with no other tool

    Both files and the Klipper restart sit in the Moonraker tab, if your browser can reach the printer.

What the generator does not do

The file is a draft and Klipper will most likely refuse it until you fix it by hand. A template downloaded as it is carries a [spoolman] section (it belongs to Moonraker), an ADXL345 on an undescribed CAN board and an include of KAMP_Settings.cfg, which the app does not create; fluidd.cfg and mainsail.cfg are both included. The board serial number and the pins of 3 of 8 boards are placeholders, and rotation_distance is the same for every printer (40 for X and Y, 8 for Z).

The Voron 2.4, Trident, RatRig V-Core 3 and VzBot 330 templates set QGL or Z-tilt, but the file has one Z motor instead of four or three: you add stepper_z1 to stepper_z3. With TMC5160 the sensorless endstop points to tmc2209. Delta, H-Bot and CrossXY are written without their own sections or as cartesian; TMC2240, A4988 and Generic get no motor sections; SuperPINDA gets no probe section; the power loss option and the standalone M600 change nothing. Marlin is not generated.

The link to the printer goes from your browser straight to its IP address (port 7125), not through the EduFacturing server, and a browser may block it from a secure page. The upload writes printer.cfg and macros.cfg into the config folder under the same names without asking, and File uploaded shows when the request does not fail: the reply is not checked. The screen opens in Bulgarian unless you come from the English site; the globe button at the top right switches screen and file comments to English.

Questions about printer.cfg and Klipper

What is printer.cfg?

The main configuration file of Klipper: kinematics, size, motors, board, heaters, probe and speeds. The generator builds it from your choices and gives it with macros.cfg.

What is Klipper?

A firmware for 3D printers where the motion is worked out on a separate small computer, for example a Raspberry Pi. Settings live in the text file printer.cfg.

How to make a klipper config?

Pick a template or choose kinematics, board, drivers and probe, open the printer.cfg tab, check the pins and download the file. macros.cfg works the same.

How much does the Klipper config generator cost?

It is part of Pro at 15 EUR a month. Pro also opens the other Pro tools.

The Klipper config generator is part of Pro

Pro costs 15 EUR a month and opens all 45 Pro tools.

Build a draft printer.cfg for your printer

Part of Pro, 15 EUR a month.