Bug: CMD/CAPSLOCK being hijacked as HYPERKEY in latest versions

Hi, the latest version of BTT seems to be incorrectly registering the CMD key as a HYPERKEY. Rolling it back to an earlier version (I tested btt4.989-2024121609) seems to resolve the problem. It is confirmed to be a BTT issue, as disabling BTT clears the problem.

For context, part of the issue could be attributable to my setup. I am using a Japanese Realforce keyboard, where the CAPSLOCK key is positioned where the GLOBE (Mac) // CTRL (Win) key usually is on the bottommost-left key of the keyboard (search Google Images for examples).

I have switched that key to CMD under "Settings -> Keyboard Shortcuts -> Modifier Keys", which BTT has respected until recent updates. Thus, I suspect that BTT might be treating that key as the default CAPSLOCK function on the Japanese Realforce keyboard - and is somehow triggering HYPERKEY based on that logic.

Could you please look into it? I currently have to downgrade to an earlier version of BTT; and even when I unselect automatic updates, it still updates automatically to the latest version of BTT and brings the problem back. For additional context, I have never manually turned CAPSLOCK into a HYPERKEY, so why is HYPERKEY being registered by BTT? I couldn't find any relevant setting under BTT Preferences.

I have tried troubleshooting for several days to no avail. Would look forward to a speedy solution, as well as answers to the aforementioned queries. Thank you.


Device information:

  • Type of Mac: M2 mac mini
  • macOS version: 15.2
  • BetterTouchTool version: version 4.910