I've taken the liberty of writing up a small, step-by-step 'How to' for compiling SDLMAME on OS X,

It's a little longer than the directions included with the source, but I believe it to be a little easier to follow for the novice.

Feel free to use it, use parts of it, rewrite it, or ignore it completely as you see fit.


Compiling SDLMAME for mac OS X for Dummies

So you've decided to compile your own copy of SDLMAME.

Follow these simple steps, and you'll be up and running in fairly short order.

Preliminary Steps (These need be done only once, with the occasional periodic updates) -

- Run Software Update -
Your Operating System, and supporting files should be updated prior to compiling SDLMAME (and should be kept up to date regardless) The minimum supported OS for SDLMAME under Mac OS X is 10.4.x (Tiger).

- Install Xcode
Xcode is a free developer environment from Apple, and although it will be used to compile SDLMAME, you will not be required to learn how to run it.
It will need to be installed prior to compiling SDLMAME. As of this writing (10/08) the current version of Xcode is 3.x (for Mac OS X 10.5.x (Leopard)), The minimum supported version of Xcode is 2.3.
Xcode is free from Apple, either as part of your original install discs (or retail copy of OS X) or as a free download from http://developer.apple.com/

- Install SDL
Simple DirectMedia Layer (SDL) is a cross-platform multimedia library designed to provide low level access to audio, keyboard, mouse, joystick, 3D hardware via OpenGL, and 2D video framebuffer. It is used by MPEG playback software, emulators, and many popular games, including the award winning Linux port of "Civilization: Call To Power."
Go to http://www.libsdl.org/ , and click the "SDL 1.2" download link in the sidebar, then scroll down to "Mac OS X" under "Runtime Libraries". Download the "SDL-1.2.13.dmg" disk image and open it.
Click 'Macintosh HD' (or whatever your Mac's hard disk is named) in the left pane of a Finder window, then open the Library folder and drag the SDL.framework folder from the SDL disk image into the 'Frameworks' folder.

You have Xcode, and SDL installed?

Great! Let's move on to the next step!

Download and unzip the latest version of SDLMAME.
Place the resulting folder in your 'Applications' folder, or wherever you want SDLMAME to live.

Open the Terminal (Applications->Utilities->Terminal).

In the Terminal window, type cd, and a space, drag the SDLMAME folder you just unzipped into the Terminal window, and hit return.

This changes the directory path to the SDLMAME folder.

Now we're about to begin the compiling process.

If you are compiling on an Intel based Mac, copy this line, and paste it into the terminal -
make TARGETOS=macosx

If you are compiling on a PowerPC Mac, copy this line, and paste it into the terminal -

In either case, hit return, and go have a sandwich, as this will take a little while.

Now, let's recap (The short version) -

- Update OS X via Software Update

- Install Xcode, and SDL (only needs to be done once)

- Unzip, and place your SDLMAME folder

- Open the Terminal, navigate to the SDLMAME folder, and type or copy the following -

make TARGETOS=macosx
(Intel Macs)


(PPC Macs)

Hit Return

That's it! You've just compiled SDLMAME!

The following statement is true...
The preceding statement is false.