pygame / doc / BuildUnix.txt

Full commit
marcus 13d1988 

marcus b943e15 

marcus 13d1988 

marcus 240dc49 
marcus 13d1988 

marcus c9ff7a6 
marcus 13d1988 
marcus 9a6a112 
marcus 13d1988 

marcus 86ce793 
marcus 9a6a112 
marcus 17178e6 
marcus b943e15 

marcus 13d1988 

marcus 02126d2 
marcus 13d1988 

marcus b943e15 

Building Pygame2 on Unix
Building Pygame2 on Unix compatible platforms, such as Linux or BSD, is
probably the easiest way of having a fully featured multimedia framework

Setting the environment
You will need a mostly C99 compatible compiler such as the GNU C
Compiler and (optionally) a make utility such as GNU make or pmake. A list of
supported compilers can be found in the section :ref:`alternative-compilers`.

Building the dependencies
.. note::

    The following list of dependencies might not be the most actual one.
    Please check the README.txt file in the top source directory for the
    most actual dependency list!

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

* Python 2.4, 2.5, 2.6, 3.1 (

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

* SDL >= 1.2.10              (
* SDL_mixer >= 1.2.11        (
* SDL_ttf >= 2.0.9           (
* SDL_image >= 1.2.10        (
* SDL_gfx >= 2.0.18          (
* libpng >= 1.2.24           (
* libjpeg >= 6b              (
* freetype >= 2.3.5          (
* portmidi >= 199            (
* OpenAL                     use one of:
  * OpenAL11CoreSDK (Aug 2009) 
  * openal-soft >= 1.11.753

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              (
* smpeg >= rev. 370          (

The next step would be to build and install those dependencies in the
correct order as required by your specific operating system. Once done
with it, you can go on to build Pygame2.

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.

.. _alternative-compilers:

Using Alternative Compilers
Pygame2 offers support for using different compilers on Unix platforms. Those

* Intel C++ Compiler suite (
* GNU C Compiler (
* LLVM Clang Compiler (

The GNU C Compiler will be used as default compiler for most Unix platforms (or
better: is installed as default compiler). To use a different compiler,
execute ::

  python build --compiler=icc
  python build -c icc 			# same as above, but shorter
for the Intel C++ Compiler or ::

  python build --compiler=clang
  python build -c clang 		# same as above, but shorter
for the LLVM Clang Compiler.