Hyper key not recognized as modifier within window switcher action

Bugs or Unexpected Behavior
,
1

Describe the bug
I want to use a "hyperkey + key" combination to switch between windows using the BTT window switcher action.

In my specific case "tab" is the hyper key and I want to map this action to "tab + w" with "w" being the key to cycle through while keeping the BTT window switcher open until I release the "tab" key.

While hyperkey is pressed, it should cycle through the list by pressing "key" again and then pick the selected item.

That's what the setting "Activate Selected After Releasing Modifier Keys" is for and what works like a charm when I use "command + key". Only when using the hyperkey keystroke combination (in my

This works fine when using not "hyperkey + key" but "command + key" instead. Only the hyper key seems not to be recognized as a modifer in this case.

Affected input device (e.g. MacBook Trackpad, Magic Mouse/Trackpad, Touch Bar, etc.):

MacBook built-in keyboard

Device information:

  • Type of Mac: MacBook Pro M4
  • macOS version: 15.3.1
  • BetterTouchTool version: 5.271

Additional information (e.g. crash logs, related issues, etc.):

2

The problem still persists with MacOS 15.5 and BTT version 5.444.

Hyper key is set to Caps Lock.

With the sample trigger+action below, you can cycle through multiple open firefox windows with "Shift+Control+Option+Command+B" but not with "Caps Lock + B".

[
  {
    "BTTActionCategory" : 0,
    "BTTLastUpdatedAt" : 1748439425.5052381,
    "BTTTriggerType" : 0,
    "BTTTriggerClass" : "BTTTriggerTypeKeyboardShortcut",
    "BTTUUID" : "325099ED-1CF5-47BE-97D4-7D323D24BF03",
    "BTTPredefinedActionType" : 366,
    "BTTPredefinedActionName" : "Empty Placeholder",
    "BTTAdditionalConfiguration" : "0",
    "BTTKeyboardShortcutScope" : 0,
    "BTTKeyboardShortcutKeyboardType" : 0,
    "BTTTriggerOnDown" : 1,
    "BTTLayoutIndependentChar" : "b",
    "BTTEnabled" : 1,
    "BTTEnabled2" : 1,
    "BTTShortcutKeyCode" : 11,
    "BTTShortcutModifierKeys" : 1966080,
    "BTTOrder" : 3,
    "BTTAutoAdaptToKeyboardLayout" : 0,
    "BTTAdditionalActions" : [
      {
        "BTTActionCategory" : 0,
        "BTTLastUpdatedAt" : 1748439425.5072689,
        "BTTTriggerParentUUID" : "325099ED-1CF5-47BE-97D4-7D323D24BF03",
        "BTTIsPureAction" : true,
        "BTTTriggerClass" : "BTTTriggerTypeKeyboardShortcut",
        "BTTUUID" : "99CF5364-9C06-4250-9F77-34717660BCE8",
        "BTTPredefinedActionType" : 100,
        "BTTPredefinedActionName" : "Show Window Switcher for All Open Apps",
        "BTTAdditionalActionData" : {
          "BTTWindowSwitcherFontSize" : 12,
          "BTTWindowSwitcherShowPopover" : 1,
          "BTTWindowSwitcherShowThumbnail" : 1,
          "BTTWindowSwitcherSort" : 0,
          "BTTWindowSwitcherAppearance" : 0,
          "BTTWindowSwitcherHeight" : 500,
          "BTTWindowSwitcherSelectNextOnRepeat" : true,
          "BTTWindowSwitcherOverrideDefaultShortcuts" : false,
          "BTTWindowSwitcherFocus" : 0,
          "BTTWindowSwitcherWidth" : 380,
          "BTTWindowSwitcherExclude" : "^(?!.*Firefox).+$",
          "BTTWindowSwitcherMousePos" : 0,
          "BTTWindowSwitcherExcludeWindowsFromOtherSpaces" : false,
          "BTTWindowSwitcherItemHeight" : 30,
          "BTTWindowSwitcherExcludeHiddenAndMinimizedWindows" : false,
          "BTTWindowSwitcherExcludeSpecific" : true,
          "BTTWindowSwitcherInitialFocus" : 1,
          "BTTWindowSwitcherTriggerOnRelease" : true
        },
        "BTTKeyboardShortcutKeyboardType" : 0,
        "BTTEnabled" : 1,
        "BTTEnabled2" : 1,
        "BTTShortcutKeyCode" : -1,
        "BTTOrder" : 1,
        "BTTAutoAdaptToKeyboardLayout" : 0
      }
    ],
    "BTTTriggerConfig" : {
      "BTTTriggerRestrictions" : "0"
    }
  }
]