Free Klipper macro · by Revotech

ORBITAfor Klipper

A load test for your printer. All axes move at once: the toolhead flies tilted orbits, a climbing spiral, transfer orbits and a figure eight, all on smooth G2/G3 arcs, while Z rises and falls along every arc. No heating, no filament. Enter your machine, watch the mission, copy the macro.

Starting values only – check them against your printer.cfg.

Orbit area, mm
Rounds, mm/s
Z axis and homing

Use your max_z_velocity. A round with 0 mm/s is skipped. These are the defaults – SPEEDS=… and Z_SPEED=… in the command override them. XY never goes above your max_velocity.

01Homing
T+ 00:00
X 0 · Y 0
Z 0 mm
Full test
–
Z travel
–
Peak Z speed
–
Rounds
–

Your macro

orbita.cfg

    

Prefer not to configure anything? The universal orbita.cfg reads the axis limits and Z speed from your printer.cfg. Straight onto the printer over SSH:

wget -O ~/printer_data/config/orbita.cfg https://revo3d.pl/media/orbita/orbita.cfg

Install in three steps

Save the file

Save it as orbita.cfg next to printer.cfg (Mainsail or Fluidd: Machine → Config files).

Include it

Add [include orbita.cfg] to printer.cfg. If you have no [gcode_arcs] section yet, add it too, with resolution: 1.0. Restart Klipper.

Launch

Type ORBITA in the console. Change the speeds right in the command: ORBITA SPEEDS=80,160,240 (one round per speed) or ORBITA SPEEDS=150 Z_SPEED=8. ORBITA ROUNDS=1 runs the first round only. The mission ends with XY homing and “mission complete”.

Before launch: empty the bed, stay at the machine and keep a hand near the emergency stop. For Cartesian, bed-slinger and CoreXY printers, not delta. The orbits stay inside the area you set and the macro never asks Z to go faster than the speed you entered.