-
Notifications
You must be signed in to change notification settings - Fork 143
Slippi on macOS
This document covers running Slippi on macOS. Please read it carefully, and follow it in order.
Sign up on slippi.gg for an account. After that, download the latest build from slippi.gg. Go ahead and install it, and then move on to the Configuring Your Controller section below.
Slippi is officially supported for the following macOS versions:
- Big Sur (Intel) (11.0)
- Catalina (Intel) (10.15)
- Mojave (Intel) (10.14)
- High Sierra (Intel) (10.13)
Slippi has beta support for the following macOS versions:
- Big Sur (M1 Apple Silicon) (11.0)
Bugs should be reported to the #mac-support channel in the Slippi Discord. When doing so, please make sure to note the following:
- What macOS version you're on
- What Mac hardware you're running on (model and processor)
-
If it's an adapter issue: the output of
ioreg | grep WUP-028 -A6 - Whatever is not working
Setting up a GameCube controller adapter in macOS requires disabling a system lock in Recovery Mode. The necessary command to run disables that lock and keeps the rest locked for security purposes.
It's important to note that kernel extensions in macOS are deprecated, and there will eventually be a new method for handling controller setup. Once that exists, it's theoretically possible that the Recovery Mode step will not be necessary.
Boot into Recovery Mode on your Mac by turning off the computer, and follow the steps below:
-
If you have an Intel Mac: hold
CMD+R, and turn on your Mac. Hold the buttons until Recovery Mode appears. - If you have an Apple Silicon Mac: hold your power button until a screen appears for entering Recovery Mode.
Once in Recovery Mode:
- Open a Terminal (in the Utilities dropdown at the top)
- Run the following commands:
csrutil disablecsrutil enable --without kext
Reboot your Mac into normal mode.
Before running any command below, make sure Slippi (and any other Dolphin instance) is closed, and that your adapter is unplugged.
To install the standard adapter driver, you can run the following command in a Terminal. It will prompt you for your password - it will not look like it types when you press keys, but it's typing.
curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/project-slippi/Ishiiruka/slippi/Data/install_smashenabler.sh | shOn some Macs - notably, newer ones that contain a T2 security chip - the driver can be "forgotten" after a reboot. To fix this, you can run:
sudo kextutil /Library/Extensions/SmashEnabler.kextIf your adapter has a Wii Mode switch, make sure it's set to that. Plug in your adapter, open Slippi, and check if it's detected in the Controllers screen.
Always make sure that Slippi and/or Dolphin is closed before plugging in your adapter.
For those who want to try a higher-poll-rate driver, you can use the driver located here. Note that this driver is tested and working on Intel Macs, but Apple Silicon usage is still newer. Read the disclaimers before trying it on Apple Silicon. Some USB-C hubs may limit the polling rate; for that there is unfortunately no workaround as it's a hardware limitation.
- If you want to try to play on a Pro Controller, you can follow this guide.
- To get a B0XX to work on Mac Slippi:
- If you do not want to manually edit the layout, use the .ini file and place it in the GCPad folder so it can be chosen as a layout. (For information on how to download .ini files to place within the GCPad folder on Mac, reference the !macuser command in the Slippi mac-support discord).
- Note that Frame1 controllers are not supported by default and need to be manually configured.
- If the adapter driver instructions don't work for you, and your adapter has a PC Mode switch, you can plug it in with that switched on and configure it as a Standard Controller. It won't be as responsive, but it is a solution for those who can't tinker with system settings.
There is currently no auto updater for Slippi on macOS yet. For now, download the latest build and follow the setup steps in this document if need be. You may need to reconfigure settings.
These should not happen after Slippi 2.2.4, but if you happen to run into them, it usually means you're trying to run the app from outside the Applicatons folder. Thus, to fix:
- Ensure you moved it to Applications
- If the error persists, move it out of Applications, then back into Applications.
- If it still persists, open a terminal and run the following:
sudo xattr -r -d com.apple.quarantine /Applications/Slippi\ Dolphin.app
You'll need to experiment with both graphics backends to see what works for you, as the performance will differ depending on macOS version and hardware.
- On Apple Silicon Macs, you might see a "crash" on closing the app. This does not appear to be a big issue and seems related to it running as an emulated process under Rosetta 2, but it's being looked into nonetheless.
- This backend is a port of an older mainline Dolphin MoltenVK/Metal backend.
- On full-screening under this backend, you may see a notification - you can ignore it.
- If your ping and FPS counters shows up as squares, try backing out to the title screen
- Ensure you're running full screen and the game is clicked. Consider running @1x resolution.
- Enable "Do Not Disturb". Notifications tank the frame rate.
- Some people have positive experiences with going to config > last tab > enable "cpu clock override" and drag the slider to 80%. Your mileage may vary, but feel free to play around.
- Some people have increased frame rates by enforcing Graphics>Enhancements Force 24-bit Color.
- Try setting aspect ratio to integer.
- Older Mac? Try cmd click on Slippi Dolphin icon in Finder -> get info -> low resolution mode.
- If both OpenGL and Vulkan run bad for you, and you're on an Intel Mac: Bootcamp it.
- If issues, ask with your macOS model and macOS version specified.