macOS/OSX Compilation / Development GuideLink

This compilation guide will teach you how to build RetroArch for macOS/OSX.

The following versions of the operating system are supported:

  • OSX 10.6 (Snow Leopard)
  • OSX 10.7 (Tiger)
  • OSX 10.8 (Mountain Lion)
  • OSX 10.9 (Mavericks)
  • OSX 10.10 (Yosemite)
  • OSX 10.11 (El Capitan)
  • macOS 10.12 (Sierra)

RetroArch can work on both 32bit and 64bit Intel processor-powered Macs.

Environment configurationLink

The following software needs to be installed:

  • XCode
  • (Optional) NVIDIA Cg Toolkit

RetroArch CompilationLink

Fetching RetroArchLink

Clone RetroArch's repository from GitHub

1
2
git clone https://github.com/libretro/RetroArch.git retroarch
cd retroarch

For subsequent builds you only need to pull the changes from the repo

1
2
cd retroarch
git pull

To update your local copy from the repository run git pull

Building RetroArch separatelyLink

Using the graphical interfaceLink

Open Xcode. Open the following project file pkg/apple/RetroArch.xcodeproj in the Xcode IDE and build (⌘-B) and run (⌘-R) it there. Or you can use the command line....

Using the command lineLink

To build a debug build :

1
2
3
4
# Build
xcodebuild -target RetroArch -configuration Debug -project pkg/apple/RetroArch.xcodeproj
# Run
open ./pkg/apple/build/Debug/RetroArch.app/

To build a release build :

1
2
3
4
# Build
xcodebuild -target RetroArch -configuration Release -project pkg/apple/RetroArch.xcodeproj
# Run
open ./pkg/apple/build/Release/RetroArch.app/

Packaging RetroArchLink

Additional Tips:Link

Core CompilationLink

Fetching CoresLink

The easiest way to fetch all the cores is to use libretro-super. Run

1
./libretro-fetch.sh

Building CoresLink

The easiest way to build all the cores (for iOS) is to use libretro-super.

To build all cores for OSX, run

1
./libretro-build.sh

In case you only want to build one and/or more cores instead of all, you can specify the cores you want to build after the first command in no particular order. E.g.:

1
./libretro-build.sh snes9x2010 fceumm

Once finished, you can find the libretro cores inside directory dist/osx.