Installation

System Requirements

  • Java 21 or later
  • Operating System: Windows 10+, macOS 12+ (Apple Silicon), or Linux (X11 or Wayland)
  • Memory: 4 GB RAM minimum, 8 GB recommended
  • Disk: ~100 MB for MapleCAM (excluding the Java runtime)

Java

MapleCAM requires Java 21 or later. Use any JDK distribution — your system package manager, your OS vendor, or a binary download from openjdk.org. To verify, open a terminal and run:

java -version

The version reported should be 21 or higher.

Download

Pick the JAR for your platform from the downloads page:

  • maplecam-alpha-windows-x64.jar — Windows on x86_64
  • maplecam-alpha-macos-aarch64.jar — macOS on Apple Silicon
  • maplecam-alpha-linux-x64.jar — Linux on x86_64

Each JAR bundles its target platform's JavaFX native libraries; pick the one that matches your OS and architecture. macOS Intel and Linux on ARM aren't published yet.

Running MapleCAM

From a terminal in the directory where the JAR was downloaded:

java -jar maplecam-alpha-<platform>.jar

On Windows, double-clicking the JAR also works once Java is installed; if Windows opens it as a ZIP archive instead, run the command above from PowerShell or cmd.

The first launch shows the machine setup wizard to capture your work area, spindle and laser capabilities, and default safe-Z heights. After that, see Your First Project for a walkthrough.