Xbox One & Xbox 360 · free · open source · macOS 15+

Your Mac ignores the Xbox dongles. This fixes that.

macOS only speaks Bluetooth and ships no driver for the USB dongles, so the Xbox Wireless Adapter, the Xbox 360 receiver and every controller behind them — including the 1537 — simply do not exist to it. GamepadBridge is a menu bar app that makes them exist.

With Homebrew
brew tap dergeorg/tap https://gitlab.dergeorg.at/mac/homebrew-tap.git
brew trust --cask dergeorg/tap/gamepadbridge
brew install --cask gamepadbridge

The middle line is not boilerplate — here is why a third-party cask has to be trusted. No Homebrew? The disk image is a drag and drop.

The GamepadBridge menu open in the macOS menu bar: two Xbox One controllers with their battery level and two Xbox 360 controllers, pairing for each receiver, the version, Open at Login and Quit
That is the whole app. No window, no Dock icon.

Watch

Plugged in to playing in 40 seconds

Install, allow two permissions, pair from the menu bar. That is all there is to it — with sound.

How it works

Three links in a chain, and macOS is missing the middle one

Everything the adapter needs already exists — it was reverse-engineered for Linux years ago. GamepadBridge brings that work to the Mac and hands the result to macOS in a form it accepts.

The adapter

The Xbox Wireless Adapter or the Xbox 360 receiver plugs into USB. macOS sees a generic device and stops there — it has no driver for either.

GamepadBridge

The app loads the adapter’s firmware, brings up its radio, pairs your controller and reads its input — or reads the Xbox 360 receiver directly. All in userspace, no kernel extension.

Your games

It then publishes a virtual gamepad for each controller, which macOS treats as a real Xbox controller. System Settings and Apple-native games see it, and so do Windows games under CrossOver.

What you get

Small app, few surprises

It does one job and stays out of the way afterwards.

A menu bar item, not a window

The icon tells you whether a controller is connected. The menu lists each one with its battery level, plus pairing and Quit. It opens at login, which you can switch off in the same menu. That is the entire interface.

Signed and notarised

Gatekeeper opens it like any other app. No right-click-Open dance, no trip through Privacy & Security to allow an unidentified developer.

No sudo, no kernel extension

Unlike Linux, macOS loads no driver of its own onto the adapter — so the app claims it as a normal user. Nothing runs as root, nothing is installed into the system.

Every controller, every button, rumble

Xbox One controllers on the adapter and up to four Xbox 360 controllers on their receiver, all at once — each a pad of its own, Xbox button included, with vibration going back to it.

Firmware, handled

The adapter needs about 200 KB of Microsoft’s firmware, which cannot be shipped with the app. The first time an adapter is plugged in, GamepadBridge offers to fetch it and checks it against a known hash. The Xbox 360 receiver needs none.

Open source, all of it

GPL-2.0-or-later, built on Medusalix’s xow. You can read every line that touches your controller, and build it yourself if you would rather.

Compatibility

Check your hardware before you install

GamepadBridge talks to the USB adapter and to the Xbox 360 receiver. If your controller already pairs over Bluetooth, macOS handles it on its own and you do not need this app.

Adapters & receivers

Xbox Wireless Adapter

first generation, the wide one

045e:02e6

Xbox Wireless Adapter

second generation, the slim one

045e:02fe

Surface built-in adapter

same silicon, different housing

045e:091e

Xbox 360 Wireless Receiver for Windows

for Xbox 360 wireless controllers, up to four

045e:0719

Xbox 360 Wireless Receiver

the earlier version

045e:0291

Controllers

Model 1537

Xbox One controller

Tested on hardware

Model 1697

Xbox One controller (2015)

Model 1698

Xbox Elite controller

Model 1708

Xbox One S controller

Model 1797

Xbox Elite controller Series 2

Model 1403

Xbox 360 wireless controller

Tested on hardware

You also need a reasonably recent Mac

macOS 15 (Sequoia) or newer, Apple Silicon or Intel. The virtual gamepad is built on CoreHID, which Apple introduced in that release — on anything older the app cannot publish a controller at all.

Steam under CrossOver: yes. Steam for Mac: not yet.

Steam running under CrossOver reads every controller, rumble included, and so do System Settings and Apple-native games. The Mac version of Steam most likely cannot: it ships SDL 3.4, and SDL 3.4 takes an Xbox pad that macOS marks as connected "virtually" for a wired one, which speaks a different protocol — the same goes for other apps built on it. Xbox 360 controllers have a way round: let Steam for Mac drive the receiver itself, and they work in Steam, though nowhere else.

Installing

Two ways in. Pick either.

They end up at exactly the same app — the difference is only whether you would rather type or click.

Plug it in and play something

Installing takes about a minute. The one thing that trips people up — the two macOS permissions — has its own step in the guide.