Running Slic3r from git on OS X

Jirka Pech edited this page Jun 1, 2016 · 17 revisions

This page contains instructions on how to run the latest Slic3r from git on Apple OS X. The instructions have been verified to work on OS X Lion (10.7) and OS X Mountain Lion (10.8). Please notice that following these instructions are not needed for running the binary releases of Slic3r for OS X available from

Installing the necessary command line tools

There are two ways to install the necessary command line tools (git, cc, ...) for installing Slic3r and its dependencies on OS X. Both require creating a free Apple ID.

Installing Xcode + Command Line Tools

One option is to install the full, graphical Xcode IDE (version 4.3 or later), which includes an option to install the necessary command line tools:

  • Download and install Xcode from the Mac App Store
  • Launch
  • Open Preferences and install the Command Line Tools from the Downloads tab

Installing the stand-alone Command Line Tools

Another option is to install the stand-alone Command Line Tools for Xcode:

OSX 10.9 Maverick

  • Newer versions of OS X (Maverick) have perl 5.16 as default with which Slic3r is not supported. The default can be changed with: defaults write Version 5.12
  • Command Line Tools can be installed with: xcode-select --install

OSX 10.11 El Capitan

Your build may fail in the last step (building GUI) on El Capitan with message similar to this:

Building and testing Alien-wxWidgets-0.67 ... FAIL
! Installing Alien::wxWidgets failed. See /Users/yourname/.cpanm/work/1464795363.4904/build.log for details.
Retry with --force to force install it.

That means you should install wxMac first by running:

brew install wxmac

Installing the Boost libraries

If you have homebrew installed, use brew install boost --universal. Otherwise you can use MacPorts or any other method you know.

Installing Slic3r dependencies as root

To instead install the Slic3r dependencies as root, execute the following steps:

git clone git://
cd Slic3r
sudo cpan App::cpanminus
sudo perl Build.PL
sudo perl Build.PL --gui

Installing Slic3r dependencies as non-root

To install the Slic3r dependencies as non-root (many people prefer not to touch their system directories), first download and unpack local::lib and execute the following commands within the newly unpacked local-lib directory:

perl Makefile.PL --bootstrap
make test && make install
echo 'eval $(perl -I$HOME/perl5/lib/perl5 -Mlocal::lib)' >> ~/.bashrc
source ~/.bashrc

Your environment is now set up for installing perl modules under ~/perl5/ (the above instructions assume you are using /bin/bash as your shell, please see the local::lib documentation for csh/zsh instructions). Next, execute the following commands to install the Slic3r dependencies:

git clone git://
cd Slic3r
cpan App::cpanminus
perl Build.PL
perl Build.PL --gui

Updating locally installed modules

An easy way to update only your locally installed modules is to parse the output of perldoc perllocal and pass the names of the locally installed modules to cpanm -i:

perldoc -t perllocal | grep Module | sed -e 's/^.* "Module" //' -e 's/-/::/g' | sort | uniq | xargs cpanm -i


  • If you have installed perl via MacPorts and the build fails, try using the original OS X version of perl (/usr/bin/perl).
  • If the build still fails, install the dependencies manually. This should fix issues with newer OS X versions.