ControllerKeys

A native macOS application that maps Xbox and PS5 Dualsense controller inputs to keyboard shortcuts, mouse movements, and scroll, magnify, pan actions.

I created this app because I wanted to vibe code with an Xbox/Dualsense controller and use all my regular shortcuts.

I found other existing apps to be lacking or not configurable enough.

With the rise of whisper-driven voice transcription, just hook up any button to your favorite voice transcription program (mine is the open-source VoiceInk) and you now have full typing abilities with only the controller.

Later on, I realized a PS5 Dualsense controller that has a built in touchpad to control the mouse is an excellent solution for this kind of program. As of v1.1.0, there is now full support for Dualsense controllers in addition to Xbox Series X|S controllers.

## Features

- **Button Mapping**: Map any Xbox/Dualsense controller button to keyboard shortcuts
  - Modifier-only mappings (⌘, ⌥, ⇧, ⌃)
  - Key-only mappings
  - Modifier + Key combinations
  - Long-hold for alternate actions
  - Chording (multiple buttons → single action)

- **Joystick Control**:
  - Left joystick → Mouse movement
  - Right joystick → Scrolling
  - Configurable sensitivity and deadzone
  - Hold modifier (RT by default) to use sensitive mouse movement

- **Touchpad Control**: Use the touchpad from a Dualsense controller with taps and multitouch gestures
  - Single finger tap → Left click
  - Two finger tap → Right click
  - Two finger swipe → Scrolling
  - Two finger pinch → Zoom in/out

- **On Screen Keyboard, Commands, and Apps**: Use the on-screen keyboard widget to quickly select apps, commands, or keyboard keys.
  - Use the controller without a keyboard with the on-screen keyboard
  - Easily enter configurable text strings and commands in Terminal with a single click
  - Use built-in variables to customize text outputted
  - Show and hide apps in customizable app bar

- **Profile System**: Create and switch between multiple mapping profiles

- **Visual Interface**: Interactive controller-shaped UI for easy configuration

- **DualSense Support**: Full PlayStation 5 DualSense controller support
  - Touchpad as trackpad or button zones
  - Multi-touch gesture support
  - Customizable LED colors in USB connection mode
  - Dualsense built-in microphone support in USB connection mode
  - Microphone mute button mapping

## Requirements

- macOS 14.0 or later
- Xbox Series X|S or Dualsense controller with Bluetooth support
- Accessibility permissions (for input simulation)