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.
- 8 templatesVoron, Ender 3, Prusa MK3S, RatRig, VzBot
- 2 filesprinter.cfg and macros.cfg
- 7 checks3 block the download, 4 only warn
- Upload to the printerby IP address through Moonraker
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.
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.
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.
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.
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.
| Applies to | Formula | Meaning |
|---|---|---|
| Speed by kinematics (Standard) | Cartesian 250 mm/s and 2000 mm/s²; CoreXY 400 and 4000; CoreXZ 300 and 3000 | become max_velocity and max_accel |
| Leveling mesh | 5 × 5 points, 30 mm in from the edges | a bed_mesh section with no QGL or Z-tilt, if there is a probe or the printer is CoreXY |
Reference
Supported MCU boards
| Parameter | Value |
|---|---|
| BTT SKR Mini E3 | built-in drivers (Ender-class) |
| BTT Octopus / Pro | 8 drivers, up to 60V |
| BTT Manta M8P/M4P | built-in CB1/CM4 slot |
| Fysetc Spider | high power, for CoreXY |
| BTT EBB SB2209 | CAN head (Stealthburner) |
The list of supported boards in the configurator
Key parameters in printer.cfg
| Parameter | Value | Unit |
|---|---|---|
| max_velocity | cartesian 250, corexy 400, delta 300 | mm/s |
| max_accel | cartesian 2000, corexy 4000, delta 3000 | mm/s^2 |
| microsteps | 16 standard, 32 for tmc5160/tmc2240 | |
| rotation_distance X/Y | 40 | mm |
| run_current TMC2209 X/Y | 0.8 | A |
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.
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.
Related tools
First layer diagnosisFirst layer problems: pick what you see on the bed, your filament and printer, and get causes, fixes and a slicer profile. Needs a free account.
AutoTowers: calibration towersTemperature tower generator plus 8 more calibration tests: retraction, flow, K-factor. STL and code for Cura, PrusaSlicer, Orca. Part of Pro, 15 EUR a month.
3D printer calibration tests3D printer calibration test with 22 models: temperature tower, overhangs, bridges, tolerances. Set it up, download an STL or 3MF. Part of Pro, 15 EUR a month.
SliceAGENT: slicer profiles3D printer slicer profiles: 4093 ready profiles for PrusaSlicer, OrcaSlicer, Bambu Studio and Cura plus an AI helper. Free account; an AI question is 3 credits.
Build a draft printer.cfg for your printer
Part of Pro, 15 EUR a month.