This guide is for building your Visual Studio 2022 solution for OrcaSlicer on Windows 64-bit.

• Visual Studio 2022 or Visual Studio 2019

  winget install --id=Microsoft.VisualStudio.2022.Professional -e

• CMake (version 3.31) — ⚠️ version 3.31.x is mandatory

  winget install --id=Kitware.CMake -v "3.31.6" -e

• Strawberry Perl

  winget install --id=StrawberryPerl.StrawberryPerl -e

• Git

  winget install --id=Git.Git -e

• git-lfs

  winget install --id=GitHub.GitLFS -e

winget install --id=GitHub.GitHubDesktop -e

1. Clone the repository:
   • If using GitHub Desktop clone the repository from the GUI.
   • If using the command line:
     1. Clone the repository:

     git clone https://github.com/SoftFever/OrcaSlicer

     2. Run lfs to download tools on Windows:

     git lfs pull

2. Open the appropriate command prompt:
   • For Visual Studio 2019:
     Open x64 Native Tools Command Prompt for VS 2019 and run:

     build_release.bat

   • For Visual Studio 2022:
     Open x64 Native Tools Command Prompt for VS 2022 and run:

     build_release_vs2022.bat

3. If successful, you will find the VS 2022 solution file in:

   build\OrcaSlicer.sln

• Xcode
• CMake (version 3.31.x is mandatory)
• Git
• gettext
• libtool
• automake
• autoconf
• texinfo

brew install gettext libtool automake autoconf texinfo

Homebrew currently only offers the latest version of CMake (e.g. 4.X), which is not compatible. To install the required version 3.31.X, follow these steps:

1. Download CMake 3.31.7 from: https://cmake.org/download/
2. Install the application (drag it to /Applications).
3. Add the following line to your shell configuration file (~/.zshrc or ~/.bash_profile):

export PATH="/Applications/CMake.app/Contents/bin:$PATH"

4. Restart the terminal and check the version:

cmake --version

5. Make sure it reports a 3.31.x version.

1. Clone the repository:

   git clone https://github.com/SoftFever/OrcaSlicer
   cd OrcaSlicer

2. Build the application:

   ./build_release_macos.sh

3. Open the application:

   open build/arm64/OrcaSlicer/OrcaSlicer.app

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

• Docker
• Git

git clone https://github.com/SoftFever/OrcaSlicer && cd OrcaSlicer && ./DockerBuild.sh && ./DockerRun.sh

The DockerRun.sh script includes several commented-out options that can help resolve common issues. Here's a breakdown of what they do:

• xhost +local:docker: If you encounter an "Authorization required, but no authorization protocol specified" error, run this command in your terminal before executing DockerRun.sh. This grants Docker containers permission to interact with your X display server.
• -h $HOSTNAME: Forces the container's hostname to match your workstation's hostname. This can be useful in certain network configurations.
• -v /tmp/.X11-unix:/tmp/.X11-unix: Helps resolve problems with the X display by mounting the X11 Unix socket into the container.
• --net=host: Uses the host's network stack, which is beneficial for printer Wi-Fi connectivity and D-Bus communication.
• --ipc host: Addresses potential permission issues with X installations that prevent communication with shared memory sockets.
• -u $USER: Runs the container as your workstation's username, helping to maintain consistent file permissions.
• -v $HOME:/home/$USER: Mounts your home directory into the container, allowing you to easily load and save files.
• -e DISPLAY=$DISPLAY: Passes your X display number to the container, enabling the graphical interface.
• --privileged=true: Grants the container elevated privileges, which may be necessary for libGL and D-Bus functionalities.
• -ti: Attaches a TTY to the container, enabling command-line interaction with OrcaSlicer.
• --rm: Automatically removes the container once it exits, keeping your system clean.
• orcaslicer $*: Passes any additional parameters from the DockerRun.sh script directly to the OrcaSlicer executable within the container. By uncommenting and using these options as needed, you can often resolve issues related to display authorization, networking, and file permissions.

All required dependencies will be installed automatically by the provided shell script, including:

• libmspack-dev
• libgstreamerd-3-dev
• libsecret-1-dev
• libwebkit2gtk-4.0-dev
• libssl-dev
• libcurl4-openssl-dev
• eglexternalplatform-dev
• libudev-dev
• libdbus-1-dev
• extra-cmake-modules
• libgtk2.0-dev
• libglew-dev
• cmake
• git
• texinfo

`./build_linux.sh -u`      # install dependencies
`./build_linux.sh -disr`    # build OrcaSlicer