Knowledge Base‎ > ‎

Building from Source on Mac

Note: Building for mac from the master branch of our current repository will no longer work, these instructions are now being updated, but we're still eagerly accepting assistance. Come visit us on freenode #singularityviewer.

Note: This will only work on MacOS 10.13 and newer, using XCode 10.

Preparation

Open the AppStore and install the latest version of XCode. Run XCode once to accept the license, then run:
xcode-select --install
You'll need to enable installing apps from anywhere for our prerequisites, open a terminal and run:
sudo spctl --master-disable
Download and install CMake, then install the CMake command line tools with this command:
sudo "/Applications/CMake.app/Contents/bin/cmake-gui" --install
Download and install mercurial, in order to install autobuild:
sudo easy_install pip
sudo pip install "hg+https://bitbucket.org/alchemyviewer/autobuild-alchemy"
Refer to Building the FMOD Studio Package to create the FMOD package the viewer requires for audio.
In a terminal, clone the Singularity source and configure it for building:
git clone https://github.com/singularity-viewer/SingularityViewer.git singularity
cd singularity/
autobuild configure -c Release -- -DFMODSTUDIO:BOOL=ON -DPACKAGE:BOOL=ON

Compiling

Open a terminal and run the following:
cd singularity/
autobuild build -c Release --no-configure
Compiling may take a while, take a break.

Running

In Finder you will be able to navigate from your home folder to singularity/build-darwin-i386/newview, here you can find Singularity.app which you can run directly and
a dmg installer image with a name like Singularity_Test_1_8_7_7029.dmg that you can use to install.

Updating

In a terminal, you may check for updates by running:
cd singularity/
git fetch
If this command gives any output, that means there's new code available, download it by running:
git pull
To have the build number change for certain:
touch indra/newview/CMakeLists.txt
Finally, repeat the Compiling step to update your build.
Comments