Mac OS X

Owned by Rye Mutt
Last updated: Mar 24, 2017
1 min read

Building the viewer on Mac OS X

Install the Development Tools

In order to build Alchemy, you will need to download a few software packages and install them. These are:

Please refer to the applicable software distributors for installation instructions.

Getting the Source Code

Our source code is hosted in a mercurial repository on Bitbucket and can be cloned to your hard drive with the following command:

hg clone https://bitbucket.org/alchemyviewer/alchemy

Configuring the Viewer

We highly recommend building with autobuild. While there are ways to build the viewer without autobuild, these methods are both unsupported and unadvised.

For a basic self-compiled build, simply run these commands from the Alchemy repository on your local machine:

autobuild configure -c RelWithDebInfoOS -- -DPACKAGE:BOOL=FALSE -DFMODSTUDIO:BOOL=TRUE

For a 64-bit build, add:

-DWORD_SIZE=64

Building the Viewer

Now that you've successful configured the viewer, start a build with the following command:

autobuild build -c RelWithDebInfoOS --no-configure

If you want to get fancy, you can configure and build in one command, like so:

autobuild build -c RelWithDebInfoOS -- -DPACKAGE:BOOL=FALSE -DFMODSTUDIO:BOOL=TRUE

The viewer may also be built from inside the Xcode IDE once you have configured the viewer, though we do not officially support this method. To do so, simply open Alchemy.xcodeproj located in the build-i386-darwin directory.

Running your Newly Built Viewer

You can run your newly created application from the repository's root directory with the following command:

open build-darwin-i386/newview/configuration-type/Alchemy.app

or, using Finder, navigate to this very same directory and double click Alchemy.