How to Reset the Bluetooth Hardware Module on Mac OS X to Troubleshoot Challenging Bluetooth Issues
Bluetooth allows wireless devices like keyboards, mouse, speakers, trackpads to be used with the Mac, and while they usually work just fine, sometimes specific Bluetooth difficulties can arise and be very frustrating to troubleshoot. Maybe it’s a persistently disconnecting device, maybe it’s a device that refuses to acknowledge a specific Mac or vice versa. Sometimes disconnecting and reconnecting with new batteries or trashing the Bluetooth preferences and an SMC reset is enough to resolve the problem, but other times issues still persist. Rather than giving up, another approach for troubleshooting particularly stubborn Bluetooth problems is to reset the Macs Bluetooth module using a little known debug menu option.
Access the Hidden Bluetooth Debug Menu in Mac OS X for Hardware Module Reset
Keep in mind this is going to disconnect every Bluetooth device on the Mac, so if you only have a Bluetooth keyboard and mouse you’re going to temporarily lose the ability to use those devices as the Bluetooth hardware module is reset.
- From the Mac desktop, hold down the Shift+Option keys and then click on the Bluetooth menu item to reveal the hidden Debug menu
- Select “Reset the Bluetooth module” from the Debug menu list
- When finished resetting, reboot the Mac as usual and go through the process of connecting the Bluetooth device(s) to the Mac as you typically would, everything should now work fine
You’ll notice there are several other options available in the Bluetooth Debug menu, including logging options, the ability to factory reset all BT connected Apple devices, and the ability to remove all BT connected items in one fell swoop, those options can be useful for other scenarios, but for troubleshooting purposes the reset seems to be most valuable.
Keep in mind that if a Bluetooth device is too far away form the Mac it may also have problems connecting to the computer as well, you can monitor connection strength of Bluetooth devices with this trick if you’re uncertain about signal quality.
This should not need to be done often since Bluetooth is typically pretty reliable on the Mac, but I had to reset Bluetooth on a MacBook Pro recently after using a PS4 controller with the Mac and later trying to add a similar PS3 controller which was refusing to be discovered by the Mac. The reset trick worked and now both gaming controllers work with the Mac as expected.
Thanks to our friend Keir over at MacKungFu for discovering the debug menu item access, this should be useful to anyone who has fumbled through troubleshooting Bluetooth issues.
This debug and reset options appear to be available only to the latest versions of MacOS and Mac OS X, but if you find it working in something prior to El Capitan let us know in the comments.
Been plagued with this problem for years … the Bluetooth Menu > Debug > Reset Bluetooth Module worked perfectly! Thank you!
I am in the iMac OS X Yosemite restore page. My brand new wireless keyboard was working last, today it is not paired with iMac. Therefore I cannot type in my wifi password, appleid & password. How do I resolve this to continue on??
I just turn the Bluetooth off and back on. It comes back working. It seems to get in some state it can’t handle.
Hold down the POWER button on your headphones for 10 seconds then re-pair the Bluetooth headphones to Mac
The bluetooth on my MacBook Air is “not available” and has the zig zag line through the icon in the upper right of my desktop.
If I option click on the bluetooth icon, nothing happens.
If I shift+option click on the bluetooth icon, nothing happens.
I have tested these on my MacBook Pro (that is not having a bluetooth issue) and these commands work perfectly.
Is there a way to run the debug program manually? It must exist somewhere on the computer, correct?
I have the same problem. Have you fixed it?
I have the same problem 😭
KUDOS!
Works great, thanks for help!
I have a 27″ IMac with Sierra OS. For reasons written several times above, my device suddenly started dropping Bluetooth capabilities. This is frustrating as every time I leave the computer inactive for a period of time, the Bluetooth drops and I can’t do anything except reboot (hard). I have tried all the “debug” suggestions. I have tried resetting the Pram. I disconnected the Bluetooth settings. I disconnected any/all Bluetooth devices. Right now I’m ready to return to Microsoft because of the inconvenience. Does anyone have any new suggestions?
When I have Bluetooth issues in the past this is what I have done, batteries are a big thing so that goes first:
– Change the Bluetooth device batteries.
– Reset PRAM
– Reset SMC
– Remove all Bluetooth plist files, reboot, then setup Bluetooth devices again
– Reset the hardware module and reboot and try again
– Try a new/different Bluetooth device see if it happens on there too.
Personally my Apple Keyboard bluetooth flakes out only when the battery is low.
Time for a different machine other than Apple. Happens every day now, and I’ve chosen not to upgrade to Catalina because the systems root level is removed from user.
Shift – Option doesn’t do anything. How else can I find the debug option? I’m losing my mind today without a keyboard and mouses. Thank you.
Hold down SHIFT and OPTION keys while clicking the Bluetooth menu, that’s how you access the Debug menu option in Bluetooth. It works, try it out on Mac OS. I am doing it right now.
Be sure you change your batteries too, if batteries aren’t charged you can’t use the Bluetooth keyboard and mouse.
thanks a lot for the fix
the issue was plaguing my MacBook Pro since time immemorial
BT audio works like a charm now
Awesome fix.
Always great to learn something new as a power user.
Thanks
So i did the shift option move and removed devices and reset under debugging but now I have no options for discovery or detecting my JBL speaker or anything else??
So close but so far. Anyone!!!????
I just updated to sierra.
Works fine with my phone so no probs speaker bluetooth….OH MAC’s I love hate love hate you!!
Didn’t work.
Macs and Bluetooth just don’t work together.
Didn’t work for me either on OS X 10.10.4… :(
FYI: Grammarish issue:
too far away form the Mac
Correction:
too far away from the Mac
Thank you.
Brilliant! fixed an issue with connectivity to one particular device, thank you. Also, keyboard and trackpad are both BT and reconnected without intervention.
Very much appreciated Pal…
J
Thanks so much for the detailed description! Worked great.
i also went and looked under the device hardware list. i clicked on bluetooth and it said “no information found”
any ideas?
i tried the shift option on my macbook air and when i click on the bluetooth icon it says”bluetooth not available” greyed out) and below that it says “create a bluetooth diagnostics report on desktop”
any other suggestions?
God bless you, the stuttering problem has been resolved almost completely and I also had a bad audio quality that is now okay.
To solve the problem of occasional stuttering, could I use a wifi antenna to amplify the signal beyond 10 meters?
I tried everything you mentioned above on my MacBook. Nothing worked. I’m confused about this now. This is the fist time I had ever experienced this.
Fixed my problem. Thank you!
I accidentally had my Mac forget bluetooth headphones. This fixed it.
Thank you!
It worked! Thx a lot! You are such a lifesaver!
Fixed my Bluetooth headphones stuttering problem. I’ve tried a bunch of things, but this actually worked.
I’m wondering how do I ‘click” when bluetooth doesn’t work??? Do I go out and buy a mouse with a cable? I still don’t know how to fix this.
This instruction seems to have partially remedied my Bluetooth stuttering problem on Sierra 10.12.3, at least for now. Running on a MacBook air, paired to a GGMM M3 Wi-Fi Bluetooth Wireless Leather Speaker. I note that the speaker paired effortlessly with my iPhone and played without stuttering.
It still stutters intermittently, whereas before the fix it stuttered constantly. I will ultimately activate the Airplay configuration of the M3.
Very valuable and thank you!
John
Kemah, TX
IT WORKED! thanks my BOHM B-66 was having issues, this fixed it
“This should not need to be done often since Bluetooth is typically pretty reliable on the Mac”
Aha, ahaha, hahahaha, hahaaa…
Thanks, I needed that.
Bluetooth performance – at least for audio devices – is by far my biggest complaint with OSX. Was on El Capitan, Yosemite, and now on Sierra.
what if its not connected it just shows me Bluetooth not available when i go to that bluetooth icon … ipress sption shift then it doesnt show me debug as you said earlier it should be coonected what if its not connected any other way out
Thank you! Your instructions above to reset fixed my Bluetooth issues! You saved me more headaches and a trip to the Apple Store and for that am grateful!
My mid-2011 Mac Mini started having an issue with the fan running at high speed while the machine was sleeping, and then wouldn’t wake from sleep (had to be powered off by holding the power button). This only seemed to happen overnight – short sleeps were okay. After a few days(nights) of this, my Magic Mouse 2 also stopped working. Resetting BT today via the debug menu fixed the mouse problem. I’ll let you know if the sleep problems are fixed as well. Thanks!
Yeah after travelling the system has picked up a lot of noise from third-party devices. If I get bluetooth refusing to reconnect after suspend I delete /Library/Preferences/com.apple.Bluetooth.plist and kill blued and toggle bluetooth in the menu bar. Still necessary with Sierra.
Where do you find that apple.bluetooth.plist? I’ve tried everything. Thank you.
Here is how you can fix the Bluetooth not available error by trashing the preference file:
https://osxdaily.com/2014/02/17/fix-bluetooth-not-available-error-mac/
This is linked in the article here:
https://osxdaily.com/2015/12/15/reset-bluetooth-hardware-module-mac-osx/
This can be helpful if your keyboard/mouse are disconnecting randomly from Bluetooth;
https://osxdaily.com/2013/05/06/fix-bluetooth-device-disconnecting/
Good luck and enjoy Bluetooth, charge those batteries too it won’t work if they are not charged.
Using El Capitan
The file
/Library/Preferences/com.apple.Bluetooth.plist
has collected an enormous amount of cached bluetooth devices, I guess they are stored everyone I take my laptop, once this file was deleted and devices are re-paired problems very lessened but no totally fixed.
Sorry guys, this is not so useful, restarting your mac usually solves all bluetooth issues I have, that’s exactly the point, I need to restart my machine in order to make the stupid mac bluetooth work.
A better trick is to reset the WiFi module:
sudo networksetup -setnetworkserviceenabled “Wi-Fi” off
sudo networksetup -setnetworkserviceenabled “Wi-Fi” on
That usually does the trick for me, but unfortunately not always.
This seems to have worked for me. Didn’t even need to re-pair the mouse, keyboard etc. (Sierra). Thanks
Thanks! Resetting bluetooth and rebooting worked perfectly. Thanks for the useful advice!
My bluetooth keyboard isnt working after installing os sierra!!! Now I cant login to my computer because I need to enter my password!!!
The problem is that I cannot find the bluetooth icon neither on the top icon nor on the system preferences!!!!
Can anyone explain what is going on with my Bluetooth please.
My Bluetooth keyboard would not work. My Bluetooth is turned off and the option to turn it on is greyed out. Then my keyboard started working. The Bluetooth still says it’s off. I can not get the full debug menu. So I can’t add any devices because it’s not on yet my keyboard works.
Thanks
Isn’t Apple going to fix this really pesky issue that makes Bluetooth devices UNusable!!!!???
The issue has been around at least since 2012. How many years do you guys need to fix a small hardware problem!?
Reboot the machine!? That is another 7 to 10 min + all the time I need to restore the state of any open applications. Altogether about 20 min.
When people pay you 4K for souped up Mac Book Pro they expect quality and robustness to save time and money. The Bluetooth issue reduces productivity and costs companies time and money.
Rather than ranting about Bluetooth on a random website that attempts to troubleshoot these issues, maybe you should contact Apple directly and let them know your concern.
The rant is well received. If enough, in enough places, maybe apple will take notice. Contacting them for this problem will not help, they only say do the above suggested which may or may not work.
Absolute trash… What are you using for reboot times like that!? I can reboot my wonderful Mac in less than two minutes and that is with it fully on the desktop, all applications opened too with that wonderful “restore your last session on reboot” feature! LOVE APPLE AND LOVE MAC BECAUSE IT IS A JOY TO USE ❤️
Thank you! Fixed my problem – headphones that wouldn’t connect
Cheers!
my sub woofer has a problem when pairing,as soon as it pairs it doesnt it doesnt produce sound and if it does its a scatched one, any one with an idea?
I have connected my bluetooth mouse, sometimes when my mac wakeup from sleep state, the bluetooth is automatically turned off in mac and it is not turning on even when i click “Turn on”. I had to restart the system anyway(even after “reset blutooth”). Is there any way to turn on bluetooth in mac without restarting ?
With only 1 meter between Macbook and bluetooth from QED i can hear a lot of noise. Reset didn’t helped at all.
This solved my BT connection issue with SoundLink Mini bluetooth speaker. Thank you.
Apple Wireless Mouse paired after some of the steps above but Apple Wireless Keyboard would not. Only thing that actually allowed successful pairing of the Apple Wireless Keyboard with a 2009 Mac mini was turning off the WiFi antenna via the WiFi menu.
Thank you so much! Your comment worked for me too.
If you press Shift+Option, then click the Wifi icon, ther will be also a Debug menu :)
Thanks! yours was the one comment that helped me fix this nagging problem.
Thanks, this might be what I need to do get my macbook to recognize some skull candy earbuds that work fine with my iPhone, but not with my macbook or iMac.
I was having a heck of a time trying to get an Auvio speaker to reliably pair with my MacBook Pro. Had to finally download Hardware IO Tools (free developer download from Apple) and use the Bluetooth Explorer to do pretty much the same thing. This shortcut would have saved me some time and, quite frankly, some bewildering menus.
I was hoping this would fix the broken AirDrop problem after upgrading to El Crapitan but no joy
I am with you, no joy with Airdrop.
Try using AirDrop compatibility mode
https://osxdaily.com/2015/11/30/enable-airdrop-new-mac-to-old-mac-support/
Airdrop works, but it’s finicky
Nope. Notta. El Crapitan won’t connect or see iOS devices anymore.
The closest I came to getting it working was to delete the bluetooth plist, create a new contact in my address book on the iOS and OSX devices with my iCloud email address, turn off the firewall and hard reboot both devices. My iOS device suddenly appeared in Finder airdrop but I couldn’t connect to it. When I tried clicking a different folder then returning to airdrop my device disappeared and is gone.
El Crapitan == Windows Vista
You only find the debug menu when you have a Bluetooth device connected.
Is the debug action only for that connection or for all possible connections to other devices?
The information about reset the bluetooth device on Mac OS X is valueable. Thanks Paul
Also shows up in 10.9.5, didn’t do reset.
I’m using Yosemite 10.10.5 and, while I didn’t go on to reset my bluetooth devices, the menu option did show up. So it works at least in Yosemite as well as El Cap.
You only find the debug menu when you have a Bluetooth device connected.
Is the debug action only for that connection or for all possible connections to other devices?
what if its not connected it just shows me Bluetooth not available when i go to that bluetooth icon … ipress sption shift then it doesnt show me debug as you said earlier it should be coonected what if its not connected any other way out