How to disable BTT hyperkey priority?

Configuration Help & General Discussion
,
1

Hello!

I'm using BTT for trackpad gestures and Raycast for Hyperkey functionality, but every time when my Mac wakes up from sleep, it stops working and shows following error:

Couldn't enable Hyper Key: Quit application
'BetterTouchTool' first.

I don't have hyper key configured in BTT, since, according to my tests, BTT Hyperkey works much more unreliably in comparison to RayCast. (Sometimes it doesn't work and I have to use shortcut 2 or even 3 times to trigger it and Process Priority Tool doesn't help with it - same problem with trackpad gestures).

So I'd prefer to keep my shortcut bindings & hyperkey setup in Raycast. But is there any way I can disable hyperkey lock from BTT?

2

bettertouchtool doesn’t block this, raycast could still enable the hyperkey - not sure why they don’t. It’s not a technical limitation

You can however configure your hyperkey in BTT instead (it has been improved a lot in recent versions and doesn't have issues anymore).

3

Hi! Thank you for you suggestion and support! I have followed your advice and tried to configure my hyperkey in BTT, but it doesn't work as much reliable and the same way as in raycast.
The main problem is I can't toggle caps lock any more, so caps lock lost it's basic functionality.
Here is my configurations settings:

image
image1278Ă—891 140 KB

image
image1028Ă—185 22.4 KB

Appreciate you help!

4

you can enable this behavior like that

  • select "Actions Executed on (Unused Hyperkey Release)"
  • add a "Toggle Caps Lock On / Off" action

image
image2468Ă—1734 243 KB

5

yes, that is, in fact, my current setup (i have posted the screenshot of that earlier). But it doesn't work :frowning: :face_with_diagonal_mouth:

6

Mhm maybe something is interfering? This is pretty well tested and used on many machines, it should work :slight_smile:

Can you maybe give some details about your BTT and macOS version? (BTT should be a current version for this to work reliably)

7

You may be right, because today my caps lock toggles just fine, yet it didn't just yesterday.
My BTT version 5.294 (2025033105)
MacOS Sonoma 14.2.1

8

Hey Andreas,

THis first action (Actions Executed on (Unused Hyperkey Release)) - if it is an action, I cannot find it in:

Action Configuration

Select a predefined action or keyboard shortcut

Would be nice if BBT could do this, as Tahoe 26.2 gives me problems with Karabiner (and Raycast complains about BTT, too!)

/
best regards,
OmarKN

9

Have a look here:
1.)

image
image2268Ă—1438 317 KB

2.)
image
image2268Ă—1438 311 KB

10

Really tricky here,

in my BBT version 5.8000 there is no thing called ”Act as Hyper Key”, at least I can’t find it, sorry.

there-is-no-Act-as-Hyper-Key
there-is-no-Act-as-Hyper-Key2325Ă—1086 109 KB

/
best regards,
OmarKN

11

You first need to record the caps lock key as that action is only assignable to that

12

Still not quite there, - -

  1. That I could not set the caps_lock was because I had the macos setting Caps-Lock: Do nothing (my misunderstanding).

  2. Howevr, when I want to ”Select a predefined action or keyboard shortcut” there I’m lost, cannot find anything, see scrdump.

    there-is-still-no-HyperKey
    there-is-still-no-HyperKey1200Ă—486 37.1 KB

13

have a look at the docs again and follow the exact steps, that should solve your issue. You first need to click where it says "Please record a keyboard shortcut" and record your caps lock key there (not as an action), then you can assign the hyperkey action to it

14

= : SOLVED!

I’m relieved, and a big thank you!

15

this works, but you lose the quick caps lock press > do nothing function. Now caps lock toggles even when pressing it lightly. I’d like it to behave like this:

  • quick caps lock press while typing > do nothing as normal on macOS
  • normal caps lock press > wait for another key. If not, toggle caps lock on release
  • caps lock + other key > hyperkey function
16

any suggestions?