Mac

Mac

Requirements

• macOS 10.13 High Sierra or newer, Intel or Apple Silicon (via Rosetta). A Mac without Metal is fine (tested on a 2010 iMac).
• A wired Xbox 360 controller (or a licensed clone, list in rust/core/src/xbox360.rs) or a PS4 controller (DualShock 4) over USB or Bluetooth.

Remove old drivers first. The 360Controller kext (360Controller, Xbox360ControllerManager) holds the Xbox controller. Uninstall it with its own uninstaller and restart the Mac. The PS4 controller needs none of this.

Install

1. Download PadBridge-<version>-macOS.zip from the Releases, unzip it and move PadBridge.app to Applications.
2. The app is not notarized, so macOS reports an "unidentified developer" on the first start: right-click the app → Open → Open again. After that it starts normally.
3. Plug in the controller (or pair the PS4 controller over Bluetooth): in the Monitor tab, sticks and buttons move along.

Only one program at a time can open the Xbox controller. Quit an old version (including the old Swift app) before starting a new one.

Allow keyboard/mouse

For PadBridge to send keys and move the mouse: System Settings → Privacy & Security → Accessibility → allow PadBridge. The app asks the first time and keeps retrying every few seconds, no restart needed.

After every new build macOS asks again, because the signature changes: remove the old entry with "–" and add it again.

Build from source

Needs the Xcode Command Line Tools and Rust:

xcode-select --install
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

git clone https://github.com/ThrowingSnow/PadBridge.git
cd PadBridge/rust
scripts/bundle-macos.sh             # builds target/PadBridge.app
cp -R target/PadBridge.app /Applications/

For a stable version, check out a tag before building, e.g. git checkout v0.6.0; the app's version number then comes from the tag.