Skip to content

how_to_build_macos

github-actions[bot] edited this page Oct 1, 2026 · 3 revisions

Build on macOS

How to building with Xcode on MacOS 64-bit.

MacOS Tools Required

  • Xcode
  • CMake
  • Git
  • gettext
  • libtool
  • automake
  • autoconf
  • texinfo
  • pkgconf

Tip

You can install most of them by running:

brew install cmake gettext libtool automake autoconf texinfo pkgconf

Important

If you've recently upgraded Xcode, be sure to open Xcode at least once and install the required macOS build support.

Point the command-line tools at your Xcode installation and accept the license:

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -license accept   # if you haven't accepted it yet

MacOS Instructions

  1. Clone the repository:

    git clone https://github.com/NanashiTheNameless/OrcaSlicer
    cd OrcaSlicer
  2. Build the application:

    ./build_release_macos.sh

    [!TIP] If you're on the latest macOS and Xcode, set the deployment target explicitly so the build targets a supported SDK, e.g.:

    ./build_release_macos.sh -s -t 15.4
  3. Open the application:

    open build/arm64/OrcaSlicer/OrcaSlicer.app

Debugging in Xcode

To build and debug directly in Xcode:

  1. Open the Xcode project:

    open build/arm64/OrcaSlicer.xcodeproj
  2. In the menu bar:

    • Product > Scheme > OrcaSlicer
    • Product > Scheme > Edit Scheme...
      • Under Run > Info, set Build Configuration to RelWithDebInfo
      • Under Run > Options, uncheck Allow debugging when browsing versions
    • Product > Run

Application Structure Overview

WIP...

Warning

!! incomplete, possibly inaccurate, being updated with new info !!

Refers to the entire application. The whole view, file loading, project saving and loading is all managed by this class. This class contains members for the model viewer, the sidebar, gcode viewer and everything else.

This is relating the the sidebar in the application window

full-sidebar

The drop down menus where you can see and select presets

combobox

Refers to the various windows with settings. e.g. the Popup to edit printer or filament preset. Also the section to edit process preset and the object list. These 4 are managed by TabPrinter, TabFilament, TabPrint and TabPrintModel respectively.

tab-popup

Clone this wiki locally