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) or File ▸ New Demo Relief Project (3D) to open a ready-made job. Both 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: default feeds and speeds are conservative starting points for plywood and hardwood, 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

See the command line for everything it does.

Getting help

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