# Hotkey just opens BetterTouchTool main window sometimes. At random. Usually it does what I programmed it to do (launch an Apple Shortcut). Other times, it just opens BTT. I have no idea how to begin debugging this. **URL:** \ **Category:** Bugs or Unexpected Behavior\ **Created:** [June 30, 2026, 10:55pm UTC](https://community.folivora.ai/t/hotkey-just-opens-bettertouchtool-main-window-sometimes-at-random-usually-it-does-what-i-programmed-it-to-do-launch-an-apple-shortcut-other-times-it-just-opens-btt-i-have-no-idea-how-to-begin-debugging-this/47331 "2026-06-30T22:55:31Z")\ **Posts on this page:** 4\ **Page:** 1
**Author:** ![George1](https://community.folivora.ai/user_avatar/community.folivora.ai/george1/32/26799_2.png) [@George1](https://community.folivora.ai/u/George1)\ **Post date:** [June 30, 2026, 10:55pm UTC](https://community.folivora.ai/t/hotkey-just-opens-bettertouchtool-main-window-sometimes-at-random-usually-it-does-what-i-programmed-it-to-do-launch-an-apple-shortcut-other-times-it-just-opens-btt-i-have-no-idea-how-to-begin-debugging-this/47331/1 "2026-06-30T22:55:31Z")
**Describe the bug** Sometimes the hotkey just opens the BetterTouch tool main window. I don't know why it's doing this. If it's trying to show me an error or something and just failing to show me the error. And I don't know where I'm supposed to look to debug this. I've tried exporting debug logs, but nothing stands out in them. The hotkey is currently working but at complete random. And I'm talking this has been driving me bonkers for months trying to find any reproducibility here. But no, it's completely random. It just stops working. The hotkey is when F5 key up happens, it launches an Apple shortcut. * * * **Affected input device (e.g. MacBook Trackpad, Magic Mouse/Trackpad, Touch Bar, etc.):** * * * **Screenshots** If applicable, add screenshots to help explain your problem. (You can just paste or drag them here) * * * **Device information:** - Type of Mac: macbook pro m5 pro 24gb ram - macOS version: tahoe - BetterTouchTool version: 6.609 * * * **Additional information (e.g. crash logs, related issues, etc.):** ---
**Author:** ![George1](https://community.folivora.ai/user_avatar/community.folivora.ai/george1/32/26799_2.png) [@George1](https://community.folivora.ai/u/George1)\ **Post date:** [June 30, 2026, 11:00pm UTC](https://community.folivora.ai/t/hotkey-just-opens-bettertouchtool-main-window-sometimes-at-random-usually-it-does-what-i-programmed-it-to-do-launch-an-apple-shortcut-other-times-it-just-opens-btt-i-have-no-idea-how-to-begin-debugging-this/47331/2 "2026-06-30T23:00:18Z")
I'm toying with "HUD Overlay show when shortcut triggered" and "0.1s delay" which so far seems to somewhat improve the reliability. Which makes me wonder if it's a race condition. This affected my m1 macbook air too, on an older version of BTT, and that the exact same thing is happening on my new m5 with newest BTT makes me wonder what kind of bug this is. It's such a simple hotkey too. On key up, run Apple Shortcut. IDK where to look for any error or what failed, or why BTT opens (is that a clue?) ---
**Author:** ![Andreas\_Hegenberg](https://community.folivora.ai/user_avatar/community.folivora.ai/andreas_hegenberg/32/39221_2.png) [@Andreas\_Hegenberg](https://community.folivora.ai/u/Andreas_Hegenberg)\ **Post date:** [July 1, 2026, 7:38am UTC](https://community.folivora.ai/t/hotkey-just-opens-bettertouchtool-main-window-sometimes-at-random-usually-it-does-what-i-programmed-it-to-do-launch-an-apple-shortcut-other-times-it-just-opens-btt-i-have-no-idea-how-to-begin-debugging-this/47331/3 "2026-07-01T07:38:11Z")
this is a bug Apple has added in a recent macOS version, you can find a workaround here: > [@Shortcuts App Bug: Bluetooth Action Errantly Opening BTT UI](https://community.folivora.ai/t/shortcuts-app-bug-bluetooth-action-errantly-opening-btt-ui/47039/5): > > I think for now you can resolve the issue using this terminal command while BTT is quit: defaults write com.hegenberg.BetterTouchTool BTTDontShowPrefsOnReopen YES I think it is fixed in macOS 26.6 ---
**Author:** ![George1](https://community.folivora.ai/user_avatar/community.folivora.ai/george1/32/26799_2.png) [@George1](https://community.folivora.ai/u/George1)\ **Post date:** [July 1, 2026, 2:09pm UTC](https://community.folivora.ai/t/hotkey-just-opens-bettertouchtool-main-window-sometimes-at-random-usually-it-does-what-i-programmed-it-to-do-launch-an-apple-shortcut-other-times-it-just-opens-btt-i-have-no-idea-how-to-begin-debugging-this/47331/4 "2026-07-01T14:09:16Z")
Thank you very much! That terminal command did seem to fix it on macOS 26.5.1.