Compiling From Source Guide
Using the guide below, we will try and walk you through the steps required to download and compile the OpenEmu application from source. You will need a Macintosh computer running OSX 10.7 or 10.8. We recommend updating to the latest version and ensuring all software is up to date...
If you have used earlier OpenEmu versions (Version 1.0b7, please see "Cleanup Earlier Versions" at the bottom before compiling OpenEmu)
###Step 1
Download and install the latest copy of XCode from the Mac App Store: https://itunes.apple.com/gb/app/xcode/id497799835?mt=12 This is free software provided by Apple. It is a hefty download weighing in at 1.5GB at time of writing. So download it, grab a coffee and see you for step 2 once the download is complete!...
###Step 2
With Xcode downloaded and installed on your computer, we now need to go and grab the source code for OpenEmu. To get this, please go to the following page: https://github.com/OpenEmu/OpenEmu and download the latest .zip repository. You will see a button labelled 'ZIP' with a little cloud like icon next to it. Click that, and your download will begin...
###Step 3
Once the ZIP repository has finished downloading, the .zip file should automatically extract and you will be left with a folder called 'OpenEmu-master' in your download location (commonly your download location will be the 'Downloads' folder in your home repository)
###Step 4
Open the folder called 'OpenEmu-master' and browse through the files until you find the XCode project file called 'OpenEmu.xcworkspace'. Double click this file and it should launch Xcode....
###Step 5
With Xcode open, you will see a lot of files and 'cores' that make up the OpenEmu application in the left sidebar. At the top of the application you will see a lot of buttons. You need to click on the funky looking long bar and select the correct 'Scheme'...
Click on the left-most portion of this bar, and be sure to scroll through the popover and select 'Build All' > 'My Mac 64 Bit'...
###Step 6
With the correct scheme selected in Step 5, you are now ready to build and compile the application. To do so, click on the 'Run' button top left of Xcode (it looks like a Play button). This will begin compiling the application. This process should take around 5 minutes or so to complete...
###Step 7
Once Xcode has finished compiling the application, it should launch OpenEmu. (if not you can find the application and launch it manually by going to Step 8 below) From here, you can begin playing your favorite games and using the application as normal (assuming that the source code you downloaded is in a usable state!)....
###Step 8
You will most likely want to use OpenEmu again after quitting the application or quitting Xcode in Step 7. XCode has compiled OpenEmu, and placed a link to it in the Products folder in the XCode Project. Make sure you are on the Project Navigator tab (underneath the Run button, you should see a Folder icon, make sure it is selected). Reveal the files in the OpenEmu Project by clicking the disclosure triangle on the OpenEmu Project, and then press the disclosure triangle for the "Products" folder. You can then control click on OpenEmu.app, and "Show in Finder".
You can of course launch the application directly from this folder, or, feel free to move it over to your applications folder so it is easier to find and launch next time!.
If you have installed or used earlier versions of OpenEmu, some things have changed that require manual cleanup to ensure proper functionality of OpenEmu 1.0.
Navigate to ~/Library/Application Support/OpenEmu and delete the "Cores" folder.
Navigate to you home folder, library: ~/Library/Preferences/ and remove the org.openemu.OpenEmu.plist preferences file there, and any files labeled OpenEmu.