Build Script for RPCS3 - Arm

This script will compile an Arm64 build of the PlayStation 3 Emulator RPCS3 for modern M-Series Macs.

[!WARNING] The script is provided for experimentation purposes only.
The LLVM recompiler does not yet have as good compatibility as the x64 build.
For maximum compatibility, download the official x64 build here and run through Rosetta.

Running the script

When downloaded, you probably won't be able to run the script at first.

• If you get a message saying that the script can't be opened, right-click on it and select Open from the context menu. You should now get a new option to Open anyway. If you are running macOS 15 Sequoia or later you may need to approve it from the Privacy & Security tab in the Settings app.
  

• The default application that is used to open the script might be set to a text editor. Change the default application by selecting the script and using Command+I to open the Get Info window (or right-click and select from the context menu). Under the Open With: section, if Terminal is not selected choose Other, enable All Applications and navigate to /Applications/Utilities/Terminal. It should now open by double-clicking it.
  

• The script was written for the Zsh shell environment. If run from the command line, use zsh build_rpcs3.sh. The script will not work properly using sh build_rpcs3.sh.

• If you have done the above steps and nothing happens when you run it, you may need to give it executable permissions. In Terminal, use the cd command to navigate to where the script is and enter chmod +x build_rpcs3.sh.
  

Note that the script will perform all actions in the same folder you run it from (likely your Downloads folder), so you may need to give it permission for this, or move it somewhere else.

It will perform the following actions:

• Check if Homebrew is installed, and install it if it isn't.
• Homebrew requires the Xcode command-line tools to be installed, so it will request that.
• Check if the required Homebrew dependencies are installed. Update if they are, install if not.
• Check if cubeb is installed. Remove if present.
• Clone the Github repository source code and build the app bundle
• Codesign the app bundle to run locally
• The app bundle will be called RPCS3-Arm.app and it will replace any older build with the same name in the same folder.
• Delete the source folder
• Reinstall cubeb if it was already present and removed earlier.

Setting up the emulator

Refer to the Quickstart Guide if you are running RPCS3 for the first time.

Before trying to run a game, always look up the RPCS3 Compatibility list to check the recommended settings. Settings can be saved on a per-game basis by right-clicking a game and creating a new custom configuration from global settings.

[!Note] If you experience graphical corruption in some games, try toggling the Disable MSL Fast Math option in the settings Advanced tab .
This is a macOS specific option that fixes several games but is often not mentioned on the compatibility pages.

Known issues

These are issues with building RPCS3 or for Arm in general.
They should be removed over time as the core issues get resolved. Issues include:

• Build failure if cubeb is installed in homebrew (workaround in script)
• Qt Frameworks are not bundled, so the app is not portable