You are here: Downloads » OS X

Installing from sources on Mac OS X

Any problem? Visit our Support Page

For all of you that want to give the newest developer snapshot with all bugs inclusive ;) a try.

In only one sentence, git is a version control system for software, detailed information is available here.

Browse online

If you only look for certain files: You can browse the current gitversion online using our github page. In the following, we describe the necessary steps in order to build your own UH out of the current git sources. It's far from being as hard as it sounds - and you might get new features as well as bug fixes! If you encounter any trouble, visit our IRC channel and we will help you out!

Get the dependencies

For Unknown Horizons you need the following dependencies:

  • scons
  • swig, swig-python
  • libsdl, +image, +mixer, +ttf
  • libpng
  • libguichan
  • boost, boost-jam
  • pyrex
  • pyyaml
  • git-core (for downloading latest UH)

For the download use MacPorts.

After installing MacPorts open your Terminal and install the dependencies with the following commands:

sudo port install swig swig-python
sudo port install py26-distribute scons libsdl libsdl_image libsdl_mixer libsdl_ttf libpng libguichan boost boost-jam py-pyrex py-yaml wget git-core

Check out SVN FIFE

Check out FIFE trunk

svn co http://fife.svn.cvsdude.com/engine/trunk

For Unknown Horizons Release 2011.3 use FIFE 0.3.3r2:

svn co http://fife.svn.cvsdude.com/engine/branches/active/0.3.3r2/

Compile FIFE

Go to your FIFE trunk directory and compile it with the following command:

scons -c && scons ext && scons

Get Unknown Horizons

Check out Unknown Horizons:

git clone git://github.com/unknown-horizons/unknown-horizons.git

For Unknown Horzions Release 2011.3 use git tag 2011.3 or download and extract the 2011.3 zip archive

Install and/or run Unknown Horizons

Install Unknown Horizons on your system:

python2.6 setup.py build

Then run Unknown Horizons from the UH source directory: (make sure python 2.6 is your system default!)

python ./run_uh.py


No git/svn available?

We can also provide this. Note, however, that you won't be able to do easy updates of UH and may need to download large packages of source code again and again. If you are unexperienced, just visit us on IRC and we will help ;-)

If you still want to choose the way that might look easier: Ignore the sections on this page that start with "Check out" and instead do the following. You will not need any version control software like svn or git.

Download the current FIFE trunk as *.zip file (available here) and download the current UH code (either as *.zip or as *.tar file). Unzip FIFE to ~/FIFE and continue until you are told to check out UH. Instead, uncompress the UH code in a way that you can afterwards find the file ~/unknown-horizons/run_uh.py . Continue with the installation.


^ Top

Previous page: Downloads
Next page: Unknown Horizons related media