Questions

How to set up a controller in Dolphin on a Mac

Open Controllers in Dolphin, set port 1 to Standard Controller, click Configure, and choose your pad in the Device menu at the top. Then click each slot and press the button you want on it. A PS5, PS4, Xbox or Switch Pro controller that the Mac already sees works this way, with nothing else installed.

The steps are from Dolphin's own guides, Configuring Controllers and the GameCube adapter guide, read on October 7, 2026. I make InputConfig, a free Mac app that maps controllers to keys and mouse. Dolphin does not need it to read a pad, and I say below where it does help.

On this page: 10 sections

1. Steps
2. Connect the pad to the Mac first
3. Map a GameCube controller
4. Map a Wii Remote layout
5. Use a real Wii Remote
6. Use real GameCube controllers through an adapter
7. If the pad does nothing
8. Where a mapper helps, and where it does not
9. The short version
10. Questions

Steps

1. Connect the controller to the Mac and check it under System Settings, Game Controllers.
2. In Dolphin, open Controllers and set GameCube port 1 to Standard Controller.
3. Click Configure and choose your controller in the Device menu.
4. Click each slot and press the button or move the stick you want on it, then click OK.

Connect the pad to the Mac first

Connect the controller to the Mac before opening the emulator. A PS5, PS4, Xbox or Switch Pro controller pairs in System Settings, Bluetooth, and shows under Game Controllers. How to connect a controller to a Mac has each one. Dolphin can only list a controller the Mac already sees.

InputConfig is completely free on the Mac App Store. You don't have to make an account, there are no subscriptions, and nothing is locked. Optimized for Apple silicon.

Map a GameCube controller

• You: Open Controllers, set port 1 to Standard Controller, and click Configure. Choose your pad in the Device menu, not the keyboard entry.
• Dolphin: Reads that pad for port 1.
• Check: Click a slot and press a button. The slot shows the button's name.

• Clear a slot. Middle click it.
• More options. Right click a slot.
• Save the layout. Type a name under Profile and save it, so a second pad or a reinstall takes a moment.

The Device menu is where most dead pads are fixed: it is still set to the keyboard.

Map a Wii Remote layout

For Wii games, set a Wii Remote slot to Emulated Wii Remote and click Configure. It works like the GameCube window: choose the pad in Device, then fill the slots. Two settings there save a lot of mapping:

• Extension. Adds an emulated Nunchuk, guitar or another Wii Remote attachment, with its own slots.
• Sideways Wii Remote. For games played with the remote on its side, such as New Super Mario Bros. Wii, without changing your layout.

An emulated Wii Remote is a set of slots, the same as the GameCube window.

Use a real Wii Remote

Set the slot to Real Wii Remote, press Refresh, and press 1 and 2 together on the remote. Dolphin's guide says not to pair the remote in the computer's Bluetooth settings, because the system can get in Dolphin's way. A real Wii Remote connects inside Dolphin, not in System Settings. The Wii Remote on a Mac has the rest.

Use real GameCube controllers through an adapter

Dolphin supports Nintendo's GameCube controller adapter directly, with rumble and no button mapping, and third-party adapters that have a Wii U mode. On a Mac there is one extra step, and it is Dolphin's own: its guide says macOS needs a small driver installed first, GCAdapterDriver, for macOS 10.13.6 and later, and notes that it does not require turning off System Integrity Protection.

1. Set a third-party adapter's switch to Wii U.
2. Install the driver Dolphin's guide links to.
3. In Controllers, choose GameCube Controller Adapter (USB) for each port in use.

The left socket on the adapter is port one. With the adapter route, the controllers need no mapping at all. How to use a GameCube controller on a Mac covers the adapter outside Dolphin.

If the pad does nothing

1. Check the Device menu. It has to show your controller, not the keyboard.
2. Press Refresh. A pad connected after Dolphin opened may not be listed yet. Restarting Dolphin does the same.
3. Turn on Background Input. Without it, Dolphin ignores the pad whenever another window is in front.
4. Check the port. A port that is turned off gives the game no controller, however well it is mapped.

A pad that works in the Configure window and not in the game is usually on the wrong port. Emulator controller not working on a Mac covers the Mac side.

Where a mapper helps, and where it does not

• Not for the pad itself. Dolphin reads controllers directly. I have not confirmed that Dolphin's Mac keyboard reader takes keys sent by a mapper, so map the pad in Dolphin.
• The Mac around Dolphin. InputConfig lets the same pad move the pointer through the game list and file dialogs, and open Dolphin from a button.
• Checking the pad. Its Live Visualizer lights each control as you press it, so you can see the Mac is getting the press.

Map the game in Dolphin, and use a mapper for everything outside the game. InputConfig switches layouts by the app in front, so its pointer layout can switch off while Dolphin is in front.

The short version

• Any modern pad. Controllers, Standard Controller, Configure, Device.
• Real Wii Remote. Refresh, then 1 and 2, with no system pairing.
• GameCube adapter. Wii U mode, the driver, then the adapter entry.

Pick the pad in the Device menu and fill the slots.

Questions

Related

• Controller not working in an emulator on a Mac
• How to use a Wii Remote on a Mac
• How to use a GameCube controller on a Mac
• A controller for DOSBox, ScummVM, and retro games on a Mac
• How to set up a controller in PCSX2 on a Mac
• How to set up a controller in RetroArch on a Mac

Completely free. You don't have to make an account, there are no subscriptions, and nothing is locked. Optimized for Apple silicon. Open source on GitHub.

Updated October 7, 2026