Machine Configuration

A machine in MapleCAM describes your CNC hardware — its physical dimensions, capabilities, and the G-code dialect it speaks.

Machine Properties

PropertyDescription
NameDisplay name (e.g., "Shapeoko 4")
Work area XMaximum X travel (mm)
Work area YMaximum Y travel (mm)
Work area ZMaximum Z travel (mm)
Spindle min RPMMinimum spindle speed
Spindle max RPMMaximum spindle speed
Supports spindleWhether the machine has a spindle
Supports laserWhether the machine has a laser module
G-code dialectGRBL or LinuxCNC
Safe ZDefault safe Z height for rapid moves

Creating a Machine

Use Tools > Machine Setup wizard, or open Tools > Manage Machines for direct editing.

The Machine Setup wizard walks you through each setting step by step. Direct editing gives you access to all fields at once.

Multiple Machines

You can configure multiple machines. Each project selects which machine it targets. The machine selection affects:

  • Available operation types (spindle vs laser)
  • G-code dialect for export
  • Work area validation (parts must fit within the machine's travel)
  • Spindle speed range validation

Machine Storage

Machine configurations are saved in your user profile (~/.maplecam/machines.json) and are available across all projects.