Compiling ScummVM under OS X
Compiling ScummVM under OS X requires setting up the build environment first, and then compiling the sources either via command line, or the XCode GUI
This can be installed from the Apple Store
XCode command line tools
After installing XCode, open a terminal and type
Get the MacPorts installer for your OS X version from the MacPorts installation page
You can install homebrew by pasting the following into a terminal:
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
You can install Fink by downloading and building the source from the Fink Source Release page
Obtaining the required libraries
After downloading the XCode command line tools and a package manager, enter the following command to install all the required libraries:
sudo port install libsdl libjpeg-turbo libmpeg2 libogg libvorbis flac libmad libpng libtheora faad2 freetype zlib fluidsynth
brew install sdl jpeg-turbo libmpeg2 libogg libvorbis flac libmad libpng theora faad2 freetype lzlib fluid-synth
4. Manual compilation
Get the source code from the libraries. With this method you will not only need to get the libraries ScummVM uses directly, but also those they depend on.
All the libraries are compiled and installed in the same way:
cd thelib-src ./configure --prefix=/path/to/install make make install
The default installation path is /usr/local, but you will need admin privileges to install the libraries in this location.
cd thelib-src ./configure make sudo make install
If you want your compilation to be compatible with older system, use the -mmacosx-version-min flag (for example -mmacosx-version-min=10.5). To force compilation in 32 bits use -arch i386. You can do that by setting environment variables before compiling all the libraries and ScummVM:
export LDFLAGS="-arch i386 -mmacosx-version-min=10.5" export CFLAGS="-arch i386 -mmacosx-version-min=10.5" export CXXFLAGS="-arch i386 -mmacosx-version-min=10.5"
bzip2 is an exception. There is no configure and you directly call make with options. For example:
make CFLAGS="-arch i386 -mmacosx-version-min=10.5 -Wall -Winline -O2 -g -D_FILE_OFFSET_BITS=64" LDFLAGS="-arch i386 -mmacosx-version-min=10.5" make install PREFIX=/Users/criezy/Dev/scummvm-releases/libs
If you plan to build the ScummVM app bundle, you will need to generate static libraries. For most of the libraries this is done by default, but for a few you need to specify you want static libraries when invoking configure. Here are suggested configure options for each library. If the library is not listed in the table below this means the default is fine.
Need to add -std=gnu89 to CFLAGS (for example 'export CFLAGS="-std=gnu89"' before invoking configure)
Compiling ScummVM via the command line
Run the configure script:
If no errors come up, you should be ready to compile ScummvM. For a list of optional features (eg additional, not yet enabled engines) run:
Here is a list of some options you may want to use:
- --enable-all-engines or --enable-engine=foo,bar to enable unsupported engines (not compiled by default)
- --with-staticlib=/path/to/install/dir if your libraries are not in a standard place (e.g. you compiled the libraries manually with a custom installation directory). This is only used when building the application bundle.
- --enable-updates --with-sparkle-prefix=/path/to/sparkle to enable Sparkle (disabled by default). The path should be the path to the directory that contains the Sparkle.framework and not the path to the Sparkle.framework itself.
Note: If you want to use Sparkle, there are some additional steps to do such as setting up DSA signatures. See  for details. ScummVM expects to find the DSA public key in dist/macosx.dsa_pub.pem.
Just run make (with -j to compile several files in parallel). For example
To recompile everything and not just the modified files:
make clean make -j4
You can run ScummVM from the command line in the build directory:
You can also generate an application bundle and move this one anywhere you want:
Some features such as dock integration are only available if you build the bundle.
Also if you run scummvm from the command line, you will need to set the Theme path in the ScummVM options so that it finds the modern theme. The themes are in gui/themes/ in the source code repository.
Compiling ScummVM via the XCode GUI
Creating an XCode project
- Compile create_project inside devtools/create_project
- Copy the generated create_project tool in the ScummVM root folder
- Run the following:
./create_project . --xcode --build-events --disable-nasm
Build the XCode project
- Open and build the XCode project
- Note that you may need to change the project architecture. Click on the ScummVM project, and change "Architectures" to "64-bit Intel (x86_64)"
- If you're using XCode 5 or newer, you will also need to go to Product -> Scheme -> Edit Scheme -> Run tab -> Options tab and uncheck "Allow debugging when using document Versions Browser", otherwise the invalid "nsdocumentrevisionsdebugmode" option will be passed to the ScummVM executable by XCode