Nintendo's controllers connect to macOS over standard Bluetooth — Apple even supports them as game controllers natively. What macOS does not do well is treat them as productivity input devices: the Home and Capture buttons are dead, button labels show up as generic A/B/X/Y instead of the Nintendo layout, and you can't use a single Joy-Con sideways or pair L+R as one device. This guide covers all three scenarios with ControllerKeys.
What You'll Need
Nintendo Controller
Joy-Con (L or R), L+R pair, or Switch Pro Controller
Bluetooth
Built-in or USB adapter
Mac Computer
macOS 11 Big Sur or later
ControllerKeys
For Home/Capture buttons, Joy-Con linking, and Nintendo labels
You Don't Need a Switch
Joy-Cons and the Pro Controller are standalone Bluetooth devices — you can buy one and use it directly with a Mac without ever owning a Nintendo Switch.
Method 1: Pair a Single Joy-Con
Find the Sync Button
The sync button is on the inner rail of the Joy-Con — the small round button between SL and SR. (When attached to a Switch, this is the edge that mates with the console.)
Enter Pairing Mode
Hold the sync button for 3 seconds until the four player LEDs at the bottom start scrolling back and forth.
Pair from macOS Bluetooth Settings
Open System Settings → Bluetooth. The Joy-Con appears as "Joy-Con (L)" or "Joy-Con (R)". Click Connect.
Launch ControllerKeys
ControllerKeys recognizes the Joy-Con and renders a single-Joy-Con preview rotated 90° — the way you actually hold one sideways. SL and SR become primary shoulder buttons; the stick becomes the main directional input.
Method 2: Pair Both Joy-Cons (L+R) as One Controller
Pair each Joy-Con individually using Method 1. macOS' GameController framework recognizes the pair and automatically merges them into a single extendedGamepad — left stick + ZL on the left side, right stick + ZR + ABXY on the right side, full D-pad on the left, +/− and Home/Capture in the middle. No manual link step in ControllerKeys is needed.
Pair Left Joy-Con
Follow Method 1 with the left Joy-Con.
Pair Right Joy-Con
Follow Method 1 with the right Joy-Con. Both now appear in your Bluetooth device list.
Both Joy-Cons Appear as One Controller
ControllerKeys picks up the combined L+R Joy-Con as a single controller automatically. The preview switches to the dual-Joy-Con layout — no manual linking required.
Method 3: Pair the Switch Pro Controller
Find the Sync Button
The Pro Controller's sync button is on the top edge, just to the right of the USB-C port. It's a small recessed button you can press with your fingernail.
Enter Pairing Mode
Hold the sync button for 3 seconds. The four player LEDs scroll back and forth.
Pair from macOS Bluetooth Settings
It appears as "Pro Controller" in System Settings → Bluetooth. Click Connect.
Launch ControllerKeys
ControllerKeys shows the correct Nintendo button labels (B = bottom, A = right, etc. — the inverted-from-Xbox layout) and captures the Home button via raw HID, which the macOS GameController framework doesn't expose.
USB-C Cable Also Works for the Pro Controller
Plug a USB-C cable directly from the Pro Controller to your Mac for a wired connection — same detection, lower latency, and it charges the controller while you use it.
What ControllerKeys Adds Beyond Native macOS Support
Correct Nintendo Labels
L/R, ZL/ZR, +/−, Capture, Home — not Xbox-style A/B/X/Y/start/select stand-ins.
Home Button Capture
The Pro Controller's Home button isn't exposed by the macOS GameController framework. ControllerKeys reads it via Nintendo's HID protocol so you can bind it.
Capture Button Capture
Same story for the Joy-Con's Capture (screenshot) button — bindable to any macOS shortcut.
Single Joy-Con Sideways Layout
The preview rotates so SL/SR become "shoulder buttons" matching how you actually hold a single Joy-Con.
L+R Joy-Con as One Controller
Pair both Joy-Cons and macOS merges them into one extendedGamepad — full ABXY, full D-pad, both sticks, both triggers. ControllerKeys shows the combined layout automatically.
Gyro Aiming
Joy-Con and Pro Controller both have gyroscopes — use them as a precision mouse with ControllerKeys' gyro-aiming feature.
Troubleshooting
Joy-Con Pairs but ControllerKeys Doesn't See It
- macOS sometimes hands the Joy-Con's HID interface to itself before ControllerKeys can claim it. Restart ControllerKeys with the Joy-Con already paired.
- If you have a Switch nearby that's powered on, it can intercept the Bluetooth pair — power the Switch off entirely or disable its Bluetooth radio while pairing to Mac.
Home Button Doesn't Register
- Apple's GameController framework hides the Pro Controller's Home button — ControllerKeys uses raw Nintendo HID to capture it instead.
- Make sure ControllerKeys 1.8 or later is running, then re-pair the Pro Controller.
Joy-Con Disconnects After Sleep
- Joy-Cons aggressively sleep. Press any button on the controller to wake it; macOS reconnects automatically.
- If reconnection fails, forget the device in Bluetooth settings and re-pair.
Sticks Drift / Joy-Con Drift
- Joy-Con drift is a well-known hardware issue. ControllerKeys can apply a dead-zone fix per stick — set Stick Deadzone to 0.10 or higher under Hardware → Joystick Settings.
- If drift is severe, Nintendo will repair affected Joy-Cons for free (in many regions). Filing a repair request fixes the hardware properly.
Make Your Joy-Con and Pro Controller a Real Mac Input Device
Native Nintendo button labels, captured Home and Capture buttons, single Joy-Con sideways layout, L+R linking, and full gyro mouse support. Plus everything else ControllerKeys does — chords, sequences, macros, JavaScript, webhooks.