The Xcode Project
for non-jailbroken iOS devices
See the original iMame4All
Google Code project for jailbroken devices
11.22.2013: See my 10-13-2013 update below for steps to get MAME4iOS on your non-jailbroken iOS device
Want to know how to build the "official" MAME project (up to 0.139) for your non-jailbroken iOS device? click here.
click here to download the iMame4All Xcode project (0.37b5 romset)
12-01-2013: Current iMame4All base version: 1.11.0 9.28.2011: Current iMame4All base version: 1.10.0 UPDATE 12-01-2013: I updated the original iMame4All project to V1.11.0 and tested it with Xcode 5 and an iPad Air running iOS 7. Follow this link
to download it. The updated project has all the latest iMame4All
changes by David Valdeita (aka Seleuco) with some modified files by me
to get it to work on non-jailbroken devices. I still recommend
installing the MAME4iOS app as outlined below (10-13-2013 update)
because (1) it includes features not available with the iMame4All app,
(2) it has a much cleaner user interface and (3) it runs the newer
0.139 romset. However if you prefer to run the iMame4All app with the
0.37b5 romset then that is up to you.
The alternative to using the Xcode project: The iMame4All Xcode project
is slowly but surely becoming out of date. Although I've heard reports of developers
successfully building this project with Xcode 5 for iOS 7 devices,
there are some changes that need to be made for it to work. I rarely
have time to keep this project up-to-date these days so I'm offering a
5 step alternative to get MAME on your non-jailbroken iOS device. Note
that you still need to be an Apple iOS developer with the ability to
sign IPAs for this to work.
Here are the steps to do this.
> Go to the iMame4All main site by clicking here.
> Download one of the MAME4iOS IPA files for non-jailbroken devices (or use this one - 1.6).
> Sign the IPA with ReSignMe.
> Install to your device using iFunBox.
> Copy your ROMs to the file sharing folder for MAME4iOS using iTunes File Sharing.
NOTE: This version of MAME is based on 0.139 so be sure to use the correct romset.
Looking for iDOS for non-jailbroken iOS devices? click here. 10.17.2012: Looking for iAmiga for non-jailbroken iOS devices? click here.
Did you download iMAME from the App Store? Click here
Follow me on Twitter for updates to the iMame4All Xcode project
This is the homepage for the iMame4All Xcode project. The goal
is to take the iMame4All source and get it to compile and build using
Xcode for non-jailbroken iPads.
A few changes were needed to get iMame4All to work with non-jailbroken
On a non-jailbroken device you do not have full access to the file
system so I had to make sure all files were loaded from the documents
directory. This posed a couple of problems.
First, you can't copy folders to the documents directory via iTunes
File Sharing so how to handle the audio samples? My solution was to
the audio samples (samples.zip) in the app bundle and access them from
the resources folder. The samples.zip file is included in the project.
Second, all roms are copied to the documents folder using iTunes
File Sharing. New folders are created here for saving game states and
configuration settings. I check to see if the roms folder is being
referenced in code and strip "roms" from the name then forward the
the documents folder.
See shared.c function
Several hard coded paths had to be changed in order for it to work on a
non-jailbroken iPad. This was solved by writing three functions in LesObjCInterface.m:
These functions in turn called the equivalent Objective-C functions to
return the appropriate paths. I then replaced all hard coded paths with
these functions as needed. BTstack and WiiMote
Sorry, can't find a good solution for the BTstack and WiiMote
controller for non-jailbroken devices. The problem is the BTstack
Daemon needs to be low-level installed but on a non-jailbroken device
you don't have access to the full file system. Also, you need chip
level access to the Bluetooth chipset which can't be done on a
non-jailbroken device. The solution here is to use the iCade arcade
cabinet or the iControlPad
controller in iCade emulation mode.
The BTstack code is still compiled in but the library is
weak-linked which means if
the low-level daemon is not installed the functions are ignored
(update: actually the app will crash if you try to connect to the
project for non-jailbroken iOS devices
The full project based on the latest (as of 12/1/2013 V1.11.0)
code can be downloaded here:
I'm using Xcode 5 and building for iOS 7 (device only - no simulator). (IMPORTANT: see notes below for Xcode 3 and iOS 4)
Check your build target. This project will only work for a device,
not a simulator. The BTstack library file is compiled for ARM hardware
and therefore will generate linker errors if you try to build the
project for the simulator.
Before building be sure to change the bundle identifier in
iMAME-info.plist to match your
provisioning file. Otherwise you'll get
code sign errors when compiling. My bundle identifier is com.lesbird.iMAME so find that and change it to what you created in the iOS Developer Portal.
Files modified for no-jailbreak (search for Les Bird):
Where do I
put the ROMs?
Copy all your zip'd ROMs to the File
folder for iMAME. Do this by connecting your iPad or iPhone to your
computer and loading up iTunes. Click on your iPad or iPhone on the
left panel then select the Apps
tab for your device. Now scroll down to the bottom of the page where it
says File Sharing. Click on
the iMAME app then click ADD
and copy all your ROMs to that folder.
4 SDK and Xcode 3 (as of 12-01-2013 probably no longer applies)
This archive has been modified to build with the latest Xcode 4.2 and
iOS 5 SDK. There are some important changes that were made for this to
work. If you are building using Xcode 3.2.6 and iOS 4 then you'll need
to replace all references of "presentingViewController"
with "parentViewController" in
all source files.
With the 1.10.0c build this change should no longer be necessary. It should build and work with both iOS 4 SDK and iOS 5 SDK.
iOS 5 and Xcode 4
CoreVideo Error (as of 12-01-2013 probably no longer applies) To fix the CoreVideo compile errors when building the project with
Xcode 4 for iOS 5 edit the project settings and remove the Framework
Search Paths except for $(inherited). The paths are setup for my
development environment but most likely will not match what you have on
iMAME on the App Store
If you downloaded iMAME from the App Store in December of 2011 here are the main differences:
First, you can't copy your ROMs to iMAME using iTunes File Sharing.
That feature had to be disabled in order to comply with App Store
guidelines. Instead you should use iExplorer and copy the ROMs to the Documents folder for the iMAME application.
Second, the readme help file talks about using WiiMotes with iMAME.
This is not possible. WiiMotes require low level access to the
Bluetooth chipset which can only be done on a jailbroken device.
However, as an alternative you can use the iControlPad which is a good handheld controller.
Make sure you are using the correct ROM set. You need ROMs for
iMame4All for GP32X which are based on the 0.37b5 version of MAME.
Somewhere out there in internet land is a complete set of iMame4All
ROMs so just do some research to find it.
on the App Store is based on the iMame4All for Xcode project with a few
changes by Jim VanDeventer to make it App Store compliant.