Compiling From Source Guide
Clone this wiki locally
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 Mac running OS X 10.11. We recommend updating to the latest version and ensuring all software is up to date.
If you have used earlier OpenEmu versions, please see Cleaning Up Previous Versions at the bottom before compiling OpenEmu.
Command Line Install Guide (Advanced users)
Not afraid of the command line? Follow this guide if you already have Xcode and Command Line Tools and want to clone and compile via terminal. Otherwise, please follow the GUI Install Guide.
Alternatively, you can easily install the necessary Command Line Tools by following this guide. Xcode is still necessary for successful compilation.
Please follow this guide to setup secure authentication with GitHub's servers otherwise you may receive an error similar to this one:
Cloning into 'BSNES'... Permission denied (publickey). fatal: Could not read from remote repository. Please make sure you have the correct access rights and the repository exists. Clone of 'email@example.com:OpenEmu/BSNES-Core.git' into submodule path 'BSNES' failed
git clone --recursive https://github.com/OpenEmu/OpenEmu.git cd OpenEmu xcodebuild -workspace OpenEmu.xcworkspace -scheme "Build All" -configuration Release
The compiled OpenEmu.app binary is located in the default DerivedData path,
~/Library/Developer/Xcode/DerivedData within a generated
OpenEmu-... folder and then inside
To get the experimental build, which includes extra work-in-progress cores, change
"Build All" to
"Build All + Experimental"
GUI Install Guide (Easy mode)
Download and install the latest copy of Xcode, which is free software provided by Apple, from the Mac App Store at https://itunes.apple.com/gb/app/xcode/id497799835. At the time of writing, Xcode is a hefty download weighing in at 1.7GB. Download it, and while waiting for it to download, grab a coffee or watch some TV.
Warning: Do not download the ZIP! It will not work!
With Xcode downloaded and installed on your computer, we now need to clone the source code for OpenEmu. Install Github for Mac from http://mac.github.com/ and create a Github account. Then, navigate to the OpenEmu repo at https://github.com/OpenEmu/OpenEmu and click "Clone in Desktop".
Note for advanced users: If you cloned OpenEmu from the command line you also need to initialize the submodules with:
git submodule update --recursive --init
Once Github for Mac has finished cloning, browse to the 'OpenEmu' folder it cloned to.
Open the 'OpenEmu' folder and browse through the files until you find the Xcode project file called 'OpenEmu.xcworkspace'. Double click this file and it should open in Xcode.
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 long bar to the right of the 'Stop' button 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'...
With the correct scheme selected in Step 5, you are now ready to compile the application. To do so, either press ⇧⌘I or click on 'Product' > 'Build For' > 'Profiling' in the menu bar. This makes sure that you get a release build that makes use of optimizations.
OpenEmu and all of its cores will now begin compiling. This process should take around 5 minutes to complete.
Once Xcode has compiled OpenEmu, simply search for OpenEmu.app in Finder, right-click on it and select 'Open Enclosing Folder'.
This should show you the application inside the 'Release' folder.
You can, of course launch the application directly from this folder. Or, if you want it to be easier to find next time, you can move it over to your applications folder!
From here, you can begin adding and playing your favorite games and using the application as normal (assuming that the source code you downloaded is in a usable state!)
Cleaning Up Previous Versions
If you have installed or used earlier versions of OpenEmu, some things have changed that require manual cleanup to ensure proper functionality of OpenEmu 2.0.
A) Remove older core and system plugins.
Navigate to your ~/Library/Application Support/OpenEmu/Cores/ folder and delete it.
Navigate to your ~/Library/Application Support/OpenEmu/Systems/ folder and delete it (If applicable. This is old and not everyone has this folder).
B) Remove older key bindings.
Navigate to your ~/Library/Application Support/OpenEmu/Bindings/ folder and delete it.
C) Remove older preferences
Run the following command in Terminal.app:
defaults delete org.openemu.OpenEmu