navi homePPSaboutscreenshotsdownloaddevelopmentforum


Here's how to get Orxonox up and running (currently due to some bugs you can't play the game right now) on macOS. It should build on anything from 10.8 (Mountain Lion) upwards (64-bit binaries for Intel processors only). The following procedure was tested on Mac OS X 10.12 (Sierra).

Current Status (as of December 5, 2016)

It should compile with LLVM/Clang on the supported OS versions. Just follow the directions in the following sections. The problem is that you can't play the game as the initial window fails to show up.

Nice To Know

Porting Orxonox to Mac OS X has taken very long now and it wouldn't have been possible without the help of the community (1337, x3n, Mozork and many others). Currently there are a lot of bugs that prevent it from running correctly so it still needs some time investment. One of the nicer new features is the addition of Cg shaders to Orxonox - maybe someone will manage to make a tutorial on that matter.


Lets assume you have a more recent installation of OS X (i.e. whatever we support: ≥ 10.8). To get you started, we first need to set up your development environment:

  • Xcode (version 4.4 or higher) it's free.
  • Cmake (You need at least 2.8.4. Get the prebuilt dmg-Image for Mac OS X Cmake or a command-line version with Homebrew)

Source Files

Important Note: Currently, you CANNOT place your orxonox files on a path with white-spaces in it! Due to the fact that the entire Orxonox build structure will not tolerate whitespaces, we will not try to implement it at all. Sorry - you'll just have to build Orxonox in folders without spaces. ;-)

Once you have your Xcode set up, you need to check out the source files and the dependency package. There are two possibilities to get the source files, either via Xcode or by using subversion in the terminal (/Applications/Utilities/Terminal). To get the files via subversion in the terminal follow these directions Subversion, or enter the following into your Terminal (without the dollar sign!):

$ mkdir -p ~/Development/Orxonox
$ cd ~/Development/Orxonox
$ svn co
$ svn co data_extern
$ mkdir trunk/build

Xcode automatically integrates with our svn repo. Do a "Checkout" of code/trunk and data/trunk. That's it, you can quit Xcode once the downloads are done.


Orxonox has a pretty impressive list of dependencies and very few of them are pre-installed on our Macs. When building with cmake they are automatically downloaded. The following link is just for reference.

Dependency Package Version Size Notes
Mac OS X 3.0 23M Package for anything beyond kicklib2

Building the dependencies on your own

You don't want to. But in case you have to, consult Dependencies for Mac OS X.

Building Orxonox

If you choose to use the Cmake gui to build it, fire up Cmake and choose your source and build directories (if you followed the tutorial to the point its ~/Development/Orxonox/trunk for the source directory and ~/Development/Orxonox/trunk/build for the build directory). Click "Configure" and choose either Xcode or Makefiles as build mode, whichever suits your preferences. Once you have everything in place, check the correct locations and then click "Configure", followed by "Generate". With the CLI Cmake simply type:

cd trunk/build
cmake .. -G Xcode # or without the "-G Xcode" if you want makefiles.

In case you're using Makefiles as build mode, you can just follow the normal steps to compile Orxonox: Buildsystem. Otherwise switch to Xcode, open up the "Orxonox.xcodeproj" file inside your build directory and hit "Run".

Playing Orxonox

I'll assume you have done the appropriate of the above sections. Run Orxonox by double-clicking on the in the build directory.

Debugging Orxonox

Apple includes its own crash reporter that collects the call stack and additional information upon the crashing of an application.

Last modified 7 years ago Last modified on Apr 9, 2017, 6:15:48 PM