Klipper configuration, without the printer.cfg guesswork
Klipper is powerful, but printer.cfg stops a lot of people at the first line. This configurator turns that blank file into a step-by-step form, kinematics, dimensions, drivers, extruder, each explained as you go, then generates a valid config and connects live to Moonraker.
Pro plan, 15 EUR/month. Includes a live Moonraker connection.How it works
Three steps, from a blank machine profile to a config talking to your printer.
Describe the printer
Kinematics, frame dimensions, drivers and extruder, one field at a time, each with an explanation of what the value actually controls on your machine.
Generate the config
The configurator turns those answers into a valid printer.cfg, so you are not staring at a blank file guessing at section names and syntax rules.
Connect to Moonraker
A live connection to the Moonraker API lets you work with the printer directly from the configurator, instead of only producing a file to copy over.
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
Built for the Klipper stack
The configurator walks through the drivers, kinematics and host setup that Klipper itself runs on.
Why this configurator
Four things a hand-written printer.cfg does not give you.
A structured process, not a blank file
Every question comes with context and a valid value range for that parameter, instead of a printer.cfg you have to write from an empty template.
Live Moonraker connection
The configurator talks to your printer over the Moonraker API directly, instead of only handing you a file to copy over by SD card or SSH.
Fewer config mistakes
A hand-written printer.cfg fails from typos, wrong section names and mismatched pin definitions. The generated config skips the syntax and logic errors that usually cause a failed start.
Built for migration and tuning
Useful whether you are moving a printer from Marlin to Klipper or refining a printer.cfg you already have running.
Klipper and Marlin split the work differently
This is the architectural difference that makes printer.cfg look unfamiliar coming from Marlin.
| Marlin | Klipper | |
|---|---|---|
| Runs the math | On the printer's own board | On a Raspberry Pi or PC, streamed to the board |
| Config format | Compiled firmware, flashed as .bin or .hex | Text config, printer.cfg, read at startup |
| Changing a setting | Usually a re-flash | Edit printer.cfg and restart the Klipper service |
| Control layer | Firmware handles everything alone | Board firmware plus the Moonraker API for host access |
| Typical strength | Simple, self-contained | Higher step rates, finer tuning, input shaping |
Because Klipper moves the heavy computation off the board, printer.cfg is not a drop-in replacement for Marlin's config file: it describes kinematics, drivers and the extruder for a system split between an MCU and a host computer, which is exactly what this configurator walks through.
Frequently asked questions
What is Klipper?
Klipper is a firmware architecture that moves the heavy step calculation off the printer's own board and onto a Raspberry Pi or another computer. That split allows higher speeds, finer motion tuning and features such as input shaping that are harder to reach on firmware running purely on the printer's own board.
What is Moonraker?
Moonraker is the API server that sits alongside Klipper. It is the bridge that interfaces, front ends and other tools use to talk to the printer, instead of each one implementing its own serial protocol. This configurator uses a live Moonraker connection so it can work with the printer directly, instead of only producing a file.
Is this for beginners or for people who already know Klipper?
Both. A beginner gets a working printer.cfg without memorizing Klipper's config syntax section by section. Someone who already runs Klipper saves the time spent hunting for the right parameter name and avoids the small mistakes a hand-written config tends to accumulate over time.
How much does it cost?
It is part of the Pro plan (15 EUR/month). Once you have Pro, generating the printer.cfg and using the live Moonraker connection are both included.
What information do I need to fill in?
You go through the printer step by step: kinematics such as Cartesian, CoreXY or delta, frame and bed dimensions, the stepper drivers on your board, and the extruder setup. Each field carries an explanation inline, so you fill in a value you actually understand instead of copying a stranger's printer.cfg from a forum.
Can I use this to migrate from Marlin, or only for a fresh Klipper install?
Both. It works for a first Klipper setup as well as for migrating an existing Marlin printer or refining a printer.cfg you already have running, since the underlying questions, kinematics, dimensions, drivers, extruder, are the same either way.
Other tools
Part of the EduFacturing tool set.
The rest of the tool set
This tool is part of the Pro plan (15 EUR/month). It is one of a set of more than a hundred engineering tools on EduFacturing: calculators, calibration helpers, slicer references, defect diagnosis, CAD utilities and printer configurators. Most of them sit behind a free account.
Create a free accountFree account. No card, no trial period.