Get started

Build NativeCAM from source

There's no packaged release yet. Building the app takes one command and Apple's free command-line tools, and gives you the same app the developers run.

What you need

  • A Mac with Apple silicon (M1 or later) running macOS 14 Sonoma or later. macOS 26 adds Liquid Glass controls.
  • The Swift 6 toolchain. The Xcode Command Line Tools are enough; you don't need the full Xcode app.
  • Git, which comes with the Command Line Tools.

Install the Command Line Tools if you haven't already:

xcode-select --install

Build and launch

Clone the repository, then build from its folder:

git clone https://github.com/NativeCAM/NativeCAM.git
cd NativeCAM
scripts/build-app.sh --open

This builds a release build/NativeCAM.app for arm64, signs it ad hoc and launches it. Drag it to /Applications to keep it. Leave off --open to build without launching. To update later, run git pull and the same command again.

First steps in the app

  1. Choose File ▸ New Demo Sign Project (2.5D), File ▸ New Demo Relief Project (3D) or File ▸ New Demo Rotary Project (3D) (a chess pawn turned on the rotary) to open a ready-made job. All three are also in the repository's examples/ folder with their G-code.
  2. Press ⌘R to simulate, and scrub the timeline at the bottom of the window.
  3. Set up your machine under Settings ▸ Machine ▸ Set Up a Machine…. New documents start on an Avid PRO6060 with Mach4 until you change it.
  4. Press ⌘E to check and export the G-code.

The first-job tutorial walks through all of this with screenshots, and setting up a machine covers the setup assistant.

Before you cut anything: the starter bits' feeds and speeds are starting points for plywood and hardwood (for softwood, MDF and particleboard, take the chip-load row's recommendation), not recommendations for every bit and material. Check the toolpaths in the simulator, read the G-code, and air-cut each new program above the material. If your controller isn't Avid Mach4, run the acceptance test first.

The command-line tool

The same engine runs without the app. From the repository folder:

swift run -c release nativecam-cli demo demo.nativecam
swift run -c release nativecam-cli post demo.nativecam -o demo.tap

The command-line reference covers every command and option.

Getting help

Read the documentation in the repository, check known limits, and open an issue for bugs, questions and results from your machine.