pygame / doc / BuildDarwin.txt

Full commit
Building Pygame2 on Darwin
Building PyGame 2 on Darwin platforms (e.g. Mac OS X) is quite similar
to building it in any other Unix-based platform with the following

Setting the environment
You will need the Darwin port of GCC and the Make utility; these
programs are automatically installed with XCode/Apple's Developers
Tools. These can be found on your second installation CD or on Apple's

Building the dependencies

Make sure, you have at least one of the following Python versions installed:

* Python 2.5 (bundled with Mac OS X)
* Python 2.4, 2.6, 3.0, 3.1 (

These versions must be installed as Frameworks: Mac OS 10.5 already
comes with Python 2.5 installed as a framework; be careful when
installing other versions: either compile them from source (safest
option) or download the appropiate precompiled builds, making sure they
do a proper Python install under Mac OS X (i.e. as framework).

To build anything, you will have to download the following additional source

* SDL >= 1.2.10              (
* SDL_mixer >= 1.2.8         (
* SDL_ttf >= 2.0.9           (
* SDL_image >= 1.2.6         (
* SDL_gfx >= 2.0.18          (
* libpng >= 1.2.24           (
* libjpeg >= 6b              (
* freetype >= 2.3.5          (

And you will need the dependency packages for the packages above:

* zlib >= 1.2.3              (
* tiff >= 3.8.2              (
* libvorbis >= 1.2.0         (
* libogg >= 1.1.3            (
* FLAC >= 1.2.1              (

Where available, the prefered way to install these dependencies is by
downloading prebuilt Framework packages: These can be downloaded for all
the SDL and SDL-dependant libraries, and they just need to be copied
into your System's Library/Framework folders, as instructed in their
respective READMEs. The build script will automatically detect them.

When Framework packages are not available, the suggested approach is to
download the library sources and build them yourself.

Optionally, you may want to use a 'ports' package manager for Mac OS X
such as MacPorts or Fink to automatically download all
dependences. However, be noted that you will need to modify the build
scripts/configuration that these programs generate, since they usually
compile the downloaded libraries for your installed architecture (either
PPC or x86): In order to link a library with a Python module, such
library *must* be built as an Universal Binary; linking will fail

Building Pygame2
Now that all dependencies are built and installed, you can proceed to
build and install Pygame2 itself. You can either use the python way of
installing the package or the make command using the Makefile.

Simply type ::

  python install 

for the traditional python way or ::

  make install

for using the Makefile. This will try to perform a default installation
with as many features as possible.