Mac gaming
Ryujinx on Mac: Ryubing setup, controllers and remote play
Identify Ryubing/Ryujinx Mac downloads, compare Stable and Canary, map a controller and test remote play with an existing game library. Once your game is running on your Mac, pair a compatible gamepad with your iPhone and use Remoted to try playing from your phone.
Check your Mac and game
The original Ryujinx project stopped development. Ryubing is a fork whose application and menus still use Ryujinx.
The inspected documentation lists macOS 12 or later and at least 8 GB of RAM. Universal Mac packages include Intel and Apple silicon code, but Intel graphics limitations can prevent usable gameplay. Stable 1.3.3 and Canary 1.3.352 were the inspected builds; Canary changes more often and can regress.
Install the Mac build and add existing games
- Choose the Mac Universal application archive from the project release. Linux AppImage and Source code downloads are different packages. Expand the archive in Finder and move Ryujinx.app to Applications.
- Open the application using Apple’s app-specific approval steps if required. Under Options → Settings → User Interface, add your existing game directory and save. Select a folder, rather than an individual game file.
- Open a game with default settings and confirm local gameplay. Keep its game update and settings constant when comparing Stable with Canary.
Choose Player 1 or Handheld
Open Options → Settings → Input. Configure Player 1 for Docked play or the Handheld slot for handheld mode. Select the input device, map the buttons and apply/save. Direct keyboard or mouse accessory settings are separate from gamepad mappings.
Steam desktop controller remapping can interfere with inputs. For sound problems, the project FAQ describes SDL2 as an audio-backend troubleshooting option; first confirm the Mac’s output and local sound.
Back up the correct save directory
The game’s context menu offers Open User Save Directory and Open Device Save Directory. Close the game before copying a backup. Saves written by a newer game update may not load with an older update; keep version information with the backup.
Start with a working local game
- Start the game on the Mac with the project’s default settings. Reach actual gameplay; a title screen alone does not establish compatibility.
- Check movement, sound and a normal in-game save. Close and reopen the game to confirm the save loads. Record the Mac model, macOS, application build and game update before changing settings.
Test the controller in gameplay
- First connect a controller directly to the Mac and select it in the application’s input settings. Choose the active player and controller type, map the inputs, then apply or save.
- Test both sticks, the directional pad, face buttons, shoulders, triggers and stick clicks during gameplay. Button letters may differ between controller layouts; map actions and positions.
- Device recognition, working buttons, motion controls and rumble are separate checks. A controller in the device list does not prove all of them work.
Remote play from iPhone or iPad
Available on the App Store · iOS 26.5 or later
macOS 26 or later · Apple silicon and Intel · Signed and notarized
- Turn on game controllers in Remoted Link on the Mac. Use the gamepad setup guide for the steps that match your Link version.
- Pair the physical controller to your iPhone or iPad, then connect through Link to the existing Mac desktop. On-screen controls use the same host setup. Keep the Mac awake and Remoted active.
- Open the game’s input settings again, choose the forwarded controller for the active player and save the mapping. Test gameplay, audio and saving again through the remote session.
- Use the controller guide for the current steps. Mac audio needs a supported High Performance connection; a private virtual-display session does not provide this controller path.
Find the cause of a problem
- If the game crashes, glitches or runs slowly on the Mac itself, start with that project’s compatibility notes. Remote play does not fix local emulation or graphics problems.
- If the picture works but buttons do not, check the forwarded controller, player slot and bindings. Reopen the game if it shows an old device list.
- If local sound works but remote sound or video fails, compare the same scene locally and remotely, then use the audio or performance guide. Change one setting at a time.