Community profile · Accessibility - General macOS

One profile
for all of macOS.

This profile isn’t tied to one app. It gives you clicks, focus navigation, held modifiers, arrow keys and system shortcuts everywhere.

Accessibility - General macOS · default mappings
Controller inputActionMac shortcut
A / crossLeft ClickMouse click
B / circleEscape / BackEsc
X / squareTabDouble-tap: Shift+Tab ⇧ TabTab
Y / triangleOn-Screen KeyboardControllerKeys action
Left bumper (LB / L1)HOLD: OptionHold ⌥
Right bumper (RB / R1)Right ClickMouse right-click
Left trigger (LT / L2)HOLD: CommandHold ⌘
Right trigger (RT / R2)HOLD: ShiftHold ⇧
D-pad upArrow Up↑
D-pad downArrow Down↓
D-pad leftArrow Left←
D-pad rightArrow Right→
Menu / OptionsSpotlight⌘ Space
View / CreateDirectory NavigatorControllerKeys action
ShareMission Control⌃ ↑
Home (Xbox / PS)Controller LockControllerKeys action
Left stick clickReturn / ConfirmReturn
Right stick clickDeleteDelete
20 button chords included
  • LT + A Copy (Cmd+C)
  • LT + B Paste (Cmd+V)
  • LT + X Undo (Cmd+Z)
  • LT + Y Redo (Cmd+Shift+Z)
  • LT + RB App Switch (Cmd+Tab)
  • LT + LB App Switch Back (Cmd+Shift+Tab)
  • LT + ↑ Mission Control (Ctrl+Up)
  • LT + ↓ App Expose (Ctrl+Down)

Labels vary by controller; match the button shown in ControllerKeys. Download Accessibility profile · Inspect it on GitHub.

Make it fit your hands

Adjust everything.

  • Cursor speed and deadzones. Slow down for precision or speed up for large screens. Controller-as-mouse guide.
  • Gyro pointing. Point by tilting a supported controller. Gyro mouse.
  • Typing. Use the on-screen keyboard, swipe typing or voice dictation shortcuts.
  • Fewer presses. Chords, macros, hold and double-tap actions put frequent tasks on a single button.
  • One-handed setups. Small controllers like the 8BitDo Micro can hold a compact layout.
Import, then make it yours

Import it.
Make it yours.

Start with the general profile, then adjust speed and buttons to what is comfortable for you.

  1. Connect and complete onboarding.

    Pair your controller with your Mac, open ControllerKeys and grant the requested Accessibility permission.

  2. Import a profile.

    Download: Accessibility general-macos.json.

    In ControllerKeys, click + beside Profiles, choose Import Profile… and select the file. The same layouts are also available through Import Community Profile….

  3. Check the linked app.

    Right-click the imported profile, choose Linked Apps… and confirm your installed app is selected. Bring that app forward and the profile switches automatically.

  4. Test, then remap.

    Move the cursor, click with A/cross, open the on-screen keyboard with Y/triangle and try Spotlight. To change a binding, open it, choose Key and press the shortcut you want.

Built by one person

Using a different app?
Tell me.

ControllerKeys is made by Kevin Tang, an indie developer. Many of these profiles started as a single email from someone describing their setup. If your app or workflow isn’t here yet, email me what you’d like to control or use Send Feedback in the app’s settings.

A few useful answers

Before you connect.

Is ControllerKeys a medical or assistive device?

No. It’s a general-purpose controller-mapping app that many people find more comfortable than a keyboard and mouse. If you have an injury or condition, talk to your clinician or occupational therapist about what suits you.

Can I use it lying down or from bed?

Yes. A wireless controller works from any position within Bluetooth range, and the cursor and keyboard are on the controller.

Does it work with macOS accessibility features?

ControllerKeys sends normal keyboard and mouse input, so it works alongside features such as Zoom, Dictation and Voice Control. Map a button to the shortcut that starts the feature.

Can I lock the controller so it doesn’t send stray input?

Yes. The general profile maps the Home button to Controller Lock, which ignores input until you unlock it.

Try a more comfortable
way to use your Mac.

Use the 14-day trial to try your controller with your own projects. Keep ControllerKeys for a one-time $19.99 purchase.

Download free trialBuy ControllerKeys · $19.99 ↗