DualBridge is a lightweight Linux utility that enables you to map your Sony DualSense controller inputs to keyboard events. It provides a seamless way to control your desktop, browse the web, or type using an integrated On-Screen Keyboard (OSK), all from your game controller.
- Full Controller Mapping: Map buttons to any keyboard key.
- On-Screen Keyboard (OSK): Built-in floating keyboard optimized for controller navigation.
- Customizable: Easy-to-use GUI for configuring key bindings.
- Auto-Start: Begins mapping automatically when launched.
- Native Integration: Installs as a system application with a desktop shortcut.
- Clone or download this repository.
- Open a terminal in the project folder.
- Run the installer:
chmod +x install.sh ./install.sh
- Important: Log out and log back in to your system. This is required to apply the necessary permission changes (process needs access to
uinputwithout sudo).
- Launch DualBridge from your application menu.
- The service starts automatically. You can minimize the window.
| Controller Button | Action |
|---|---|
| PS Button | Super / Left Meta (Mission Control) |
| Cross (X) | Enter |
| Circle (O) | Escape |
| Square | Backspace |
| Triangle | Space |
| L1 / R1 | Volume Down / Up |
| Share | Print Screen |
| Options | Toggle On-Screen Keyboard |
When the OSK is open (press Options to toggle):
- D-Pad: Navigate keys.
- Cross (X): Type selected character.
- Square: Backspace.
- Triangle: Space.
- L2: Move Cursor Left.
- R2: Move Cursor Right.
To change mappings:
- Open the DualBridge window.
- Click "Configure Keys".
- Select new keys for any button.
- Click "Save & Close".
- Changes take effect immediately (or after a quick restart of the bridge).
To remove the application, delete the /opt/dualbridge directory and the desktop file:
sudo rm -rf /opt/dualbridge
sudo rm /usr/share/applications/dualbridge.desktop