Introduction: Use an Xbox 360 Controller on OS X (wired + Wireless)

Picture of Use an Xbox 360 Controller on OS X (wired + Wireless)

I picked up Borderlands 2 for OS X in the recent Steam sale because friends of mine would NOT shut up about the game. So I fired it up only to find out that I needed to use a keyboard (lots of keys) + a mouse (carpal tunnel = no) to play. That sucks. I was hoping that I could use a borrowed Xbox 360 controller to play through, but Aspyr doesn't support that. Grr.

So after some research I found a way to use both a wireless Xbox 360 controller as well as a wired third-party Xbox 360 controller. This worked for Borderlands 2 and other games I've tried so far. The cost for this is $5 for the wired controller and $20 for the wireless. Here are the two setups that worked for me.

Step 1: Wireless Xbox 360 Controller

Picture of Wireless Xbox 360 Controller

To connect the wireless 360 Controller to my Macbook Pro I got this wireless gaming receiver for $15 (incl. tax) on Amazon.

The computer still wasn't recognizing it, so I installed Tattiebogle 0.11 which you can download here. Follow the instructions for installing and then open up the "Xbox 360 Controllers" icon in your System Preferences.

Link up your controller to the receiver and you should now be able to see reactions to you messing around with buttons and analogs on the 360 controller.

This is great, but many games will still not recognize your controller. So now you need to map your buttons to keyboard commands. To do that you will need to get Joystick Mapper in the App Store.

Once you're in Joystick Mapper you can assign all of the buttons and analogs to keyboard and mouse controls. This will take some trial and error to find out what works best for you, but it does work.

Step 2: Wired (third-party) 360 Controller

Picture of Wired (third-party) 360 Controller

There are many many different 360 controllers out there. Fortunately, there are people out there who can help you out. Once you have Tattiebogle installed you can add support for more controllers.

After installing Tattiebogle like described in the last step for the wireless controller, download this link and run the command script to update Tattiebogle. This comes from Shoryuken forum member EddDeDuck. The forum post I found this is here.

(Note: found out the link for the command script is now broken. File attached to this step)

You will also need the Joystick Mapper app from the App Store to make this work.

OK, that's it. Have fun.

Step 3: FAQ

Why play games on a Mac?

It's what I have. For my work, the Mac works really well. If I was gonna be serious about games, I'd build a desktop machine. Fortunately, the Mac gets a few games thrown its way as well.

Why are you playing on windowed mode?

I'm not. I play on full-screen. It's windowed here to emphasize that it's OS X and not Boot Camp or Parallels.

Why not use keyboard + mouse?

I've had lots of problems with mice in the past with some carpal tunnel issues. They hurt my wrists after using them intensely for 10+ years.


bandrewstanger (author)2017-02-25

Will this work on my xbox one controller or will i have to do something different

ОлегР4 made it! (author)2016-09-16

Thank you!

theserdzo made it! (author)2015-12-03

Took a while but just a note for the dudes out there who are on El Capitan, you need to go beta and update the driver when it comes out.

Here are the links I followed to get mine working.

Credits to the guys who wrote the threads on the forums found below. ?


Complete Uninstall of previous drivers which I also found helpful.

ChrisP177 (author)theserdzo2016-01-18

Thank you so much!!

TristanB17 (author)theserdzo2015-12-13

Props for posting these updated instructions

discodemonica (author)theserdzo2015-12-12

Heya! I got this driver a few days ago and noticed that my computer (mac, el cap) has now started restarting after i plug the controller out. After restarting it will sometimes be recognized as a controller the couple games i use it for and other times I have to keep trying, or just quit. v.v Did you experience any of this?

theserdzo (author)discodemonica2015-12-13

Can't say that i did. I have other issues with my mac that cause random restarts. After the restart try googling the report it gives you. If the issue is software related, there should be a fix somewhere on the forums(most likeley its a kernel thingy), if its a hardware issue, like in my case (a faulty airport adapter). gather all them precious moneyz and pay up son ?

Rovhell (author)2015-10-21

This worked for me in YOSEMITE :

  1. Install the driver from above as normal
  2. Open Terminal and type the following command:

sudo nvram boot-args="kext-dev-mode=1"

  1. Reboot your computer. When it's back up, open terminal again and type the following command all at once:

sudo kextcache -m /System/Library/Caches/ /System/Library/Extensions

Reboot again and your Xbox controller should be working!

EvaldasJ1 (author)Rovhell2015-12-28

Thanks! This worked for me.

NotoV (author)Rovhell2015-11-14

Hi, I did this and I got the following error, does anyone know what I can do?

Untrusted kexts are not allowed

WirelessGamingReceiver.kext has invalid signature; omitting.

Untrusted kexts are not allowed

Wireless360Controller.kext has invalid signature; omitting.

kext file:///System/Library/Extensions/SiLabsUSBDriver64.kext/ is in hash exception list, allowing to load

kext file:///System/Library/Extensions/JMicronATA.kext/ is in hash exception list, allowing to load

Untrusted kexts are not allowed

360Controller.kext has invalid signature; omitting.

More info:

I used parallels and created a virtual machine. when I plugged in my xbox 360 receiver, it asked me if I wanted to map it to my Parallels virtual machine or my computer (my Mac). I mapped it to parallels. But now I am trying to map it back to my Mac and I have no idea how to because the 360 receiver hardware isn't registering in the driver configuration settings for the 360 wireless receiver..

however, the controller has been registered by my system profile. tldr; my mac recognizes my controller, but the drivers don't, and I think the cause of the problem is because somehow my controller is tied to my parallels virtual machine desktop.

Additionally I fear somehow some of my system memory is somehow tied up in parallels and not accessible from my mac desktop. not sure if that's even possible but it appeared my video card RAM was lower than the specs should be in my system profile. but I'm a noob so i could be wrong.

DonatasT1 (author)NotoV2015-11-29

Are you possibly on El Capitan? It has rootless mode by default and "The kext-dev-mode and rootless boot-args are being removed from OS X El Capitan and will no longer work."

To disable rootless and enable custom kexts in el cap, you have to do that in a recovery. Instructions:

Just did it myself on my El Cap machine. Now i'm using my xbox 360 controller for Portal 2 from steam and it works great!

GarethL3 (author)Rovhell2015-10-24

Thanks very much, worked for me.

Rickybobby13 (author)2015-07-27

I have a wired xbox 360 controller it broke before the split that connects to the small piece that has the usb . When I opened it the metal end fell out I do not know what wires go where anyone know?

ShaneP6 (author)2015-07-15

hasans3 (author)2015-06-11


can i use any joystick for controlling mouse movements on win 8 and instead of mouse?but not for games.

Jean-MichelL (author)2015-06-01

Just a note, don't forget to sync your controller with your receiver! To do so, use the sync button on your receiver and the one on your controller (while both are on and ready). Skipped this step and couldn't figure out what was wrong, so just adding the info to help the next person with the same problem.

caleb.jones.1213 (author)2014-12-31

Note, if you're on Yosemite you'll need to install an unofficial version of the driver from

Here is the newest version of Driver XBox360 controller (wired and wireless) for Mac Yosemite 10.10.3

jasch1n (author)caleb.jones.12132015-03-02

thanks. I figured as such...wasn't working from just the initial download from tattiebogle.

caseyablock (author)2015-04-06

Nice ... thanks for posting this. The yosemite driver worked perfectly after rebooting, then unplugging USB and plugging back in. Got my night planned now playing old sNES and NES games!

Here is a new version of the "xbox driver" out from RodrigoCard signed for Yosemite "Xbox 360- version 0.15 Beta#92. This is a direct download link

stefwill (author)2015-03-20

Thanks for that. Was really easy to follow.

faithaffair (author)2015-03-15

It works!

My setup:
Mbp Retina 2014
XBOX 360 wireless controller
PC receiver (3rd party)
Joystick manager (App store)
And the lifesaving unofficial driver

stephen.k.jessop (author)2015-01-10

Im not getting any controller vibration! Did everything like you said and the game runs great with the controller.

Only thing is theres no vibration. Im using a wired Afterglow controller by pdp. Any thoughts?

JoshB6 (author)2014-12-26

Is the Joystick Manager app actually Joystick Mapper? Is it free?

paolascorpio (author)JoshB62015-01-09

Yes, and no. It costs $4.99 at Mac Store.

ViniciusF1 (author)2015-01-06

Try it :

calebr2 (author)2014-11-04

Check out my video on how to use the Xbox One Controller on MAC OS X :) Link:

clay.mcderpison (author)2014-07-28

I looked through all the controllers that are supported (trust me, it's hard to find the specific one you have) and mine is there (PowerA Mini Pro EX Blue) but still isn't recognized by Tattiebogle. any help?

GlenV (author)clay.mcderpison2014-08-01

i second this

maloz (author)2014-01-29

When the wireless one goes into sleep and you put it back on, some Apps do not recognize it is turned back on and you need to restart the App. Happening e.g. in SNES9X or ZSNES. This sucks...

KatherineSchreiber (author)2013-09-06

nice one

rasheednyc (author)2013-08-06

Worked perfectly (wired). Now, if I can only remember what I programmed.

donkeyknee (author)2013-07-18


jbushman (author)2013-04-27

Sadly, it appears that the driver does not work with the newest xbox 360 wired controller. There was $35 well spent. Sigh...

jobergy (author)2013-01-13

Hey! do you use Steam for Borderlands 2? If so add me! Jobergy is steam username as well

killersquirel11 (author)2013-01-11

Fair warning: A lot of the receivers you can find online are counterfeit, some of which don't work quite right and require a bit more fun to get working, your luck may vary; I got an official one when I got mine.

AlternateLives (author)2013-01-06

For gamepads on Mac computers, one of the best programs I've used is GamePad Companion, found in the App Store. It will set you back 8$, but it will support almost every controller you throw at it, including PS2 and XBox 360 (which requires a separate driver, but the developer provides the link.)

I'm using a PS2 controller, and it works for all my emulators, as well as a few indie games I play. Haven't tried it with HL2 yet, though.

I saw that and was going to try it, but Joystick Mapper worked just fine so I stopped there.

bolsontanker (author)2013-01-06

Hello. Thank you for the instructable! Do you have a copy of that could be mirrored? That one is giving a 404. :)

Weird, don't know why that broke. Uploaded the zip to step 2.

About This Instructable




Bio: I like to make things for the internets. I also sell a pretty cool calendar at You'll like it.
More by fungus amungus:3D Printed US Population MapLight Painting With an IPhoneSuper Bright RGB LED Bike Wheels
Add instructable to: