Repository navigation
DS4 Bridge 1.0 🎮
The biggest update so far: a full settings window, per-game profiles, gyro aiming, desktop mode and an AppImage that runs on most distros.
⬇️ Download
DS4_Bridge-1.0-x86_64.AppImage(recommended): download,chmod +x, run.ds4_bridge_tray: plain executable.
Both need glibc 2.34+: Ubuntu 22.04+, Debian 12+, Linux Mint 21+, Fedora 35+, Arch and other rolling distros. On older systems, compile from source (see README).
✨ New
- Settings window with tabs for buttons, sticks & rumble, gyro and desktop mode
- Full button remapping: every button (incl. Share / Options / PS, L3 / R3, D-pad) can be mapped to any Xbox button or disabled
- Per-game profiles: switch automatically while a game runs (e.g.
eldenring.exe) and switch back when it closes - Gyro aiming with the right stick or mouse pointer, with calibration (needs working motion sensors; many clones don't have them)
- Desktop mode (PS + Options): use the controller as mouse and keyboard
- Controller test window: see stick drift live and pick the right deadzone
- Round deadzone per stick, rumble strength, invert Y, swap sticks, digital triggers
- Virtual controller type: Xbox 360, Xbox One S or DualShock 4 (PlayStation button icons)
- Battery per controller with charging indicator
- One-click fix for
/dev/uinputpermissions - Languages: English and Azərbaycanca
- Works with both Ayatana and legacy AppIndicator automatically, with a classic tray icon as fallback
🐛 Fixed
- Changing the button mapping while playing could leave a button stuck
- Status showed "Running" even when
/dev/uinputcould not be opened - Battery could be read from a mouse or headset instead of the controller
- Two tray instances could run at the same time
- The log file grew without limit (now capped at 1 MiB)
⚠️ Notes
- Settings moved to
~/.config/ds4-bridge/settings.ini; your oldsettings.jsonis imported automatically. - Logs are now in
~/.local/state/ds4-bridge/. - On GNOME, the "AppIndicator and KStatusNotifierItem Support" extension is needed to see the tray icon.