# Create A Custom Hyper Key **URL:** \ **Category:** Tutorials\ **Created:** [February 23, 2025, 12:11pm UTC](https://community.folivora.ai/t/create-a-custom-hyper-key/42495 "2025-02-23T12:11:26Z")\ **Posts on this page:** 16\ **Page:** 1
**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:** [February 23, 2025, 12:11pm UTC](https://community.folivora.ai/t/create-a-custom-hyper-key/42495/1 "2025-02-23T12:11:26Z")
**Note:** If you just need a cassic Hyper Key (i.E. press Caps Lock to press ctrl + opt + cmd + shift (optional)) follow the standard instructions here: [Defining a Hyper Key ยท GitBook](https://docs.folivora.ai/docs/1004_hyper_key.html) ## **Custom Hyper Key Tutorial** In v5.221 I have made some improvements to key sequences that allow you to create custom, reliable Hyper Keys for almost any keyboard key. These custom Hyper Keys can include exactly the modifier keys you want. They require a little bit of setup, thus I have created this tutorial. In this video I show how to: - Create a Hyper Key that is triggered by pressing the Right-Shift-Key - This custom Hyper Key presses ctrl and option - Execute an action if Right-Shift has been pressed briefly without triggering any other shortcut. The example shared in the video can be downloaded here: [custom\_hyper2.bttpreset](https://community.folivora.ai/uploads/short-url/tbpzSwzyKeIh0VGtSmqAQmzAl1o.bttpreset) (12.0 KB) Steps required: - Disable the key you want to use as custom hyper key by remapping it to do nothing via "Automations, Named & Other Triggers =\> Remap Key" - Create separate Key Sequences for key down and key up. - Optionally create an additional Key Sequence for Key Down and Key Up, that one is triggered if the Hyper Key has only been pressed briefly. ---
**Author:** ![Frank1](https://community.folivora.ai/letter_avatar_proxy/v4/letter/f/a87d85/32.png) [@Frank1](https://community.folivora.ai/u/Frank1)\ **Post date:** [February 23, 2025, 12:48pm UTC](https://community.folivora.ai/t/create-a-custom-hyper-key/42495/2 "2025-02-23T12:48:37Z")
![image](https://community.folivora.ai/uploads/default/original/3X/e/9/e914311bf97817dd40c1956aea5c245ef3ff3847.png) This is very good. ๐Ÿ˜ƒ It eliminates a lot of questions. Assuming you can find the button. The actual function looks interesting, but unfortunately a dummy like me doesn't understand it straight away. In your example, the right shift function is eliminated? ---
**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:** [February 23, 2025, 1:10pm UTC](https://community.folivora.ai/t/create-a-custom-hyper-key/42495/3 "2025-02-23T13:10:26Z")
correct, in this example the right shift is replaced by a custom hyper key that presses opt+ctrl ---
**Author:** ![Frank1](https://community.folivora.ai/letter_avatar_proxy/v4/letter/f/a87d85/32.png) [@Frank1](https://community.folivora.ai/u/Frank1)\ **Post date:** [February 23, 2025, 1:24pm UTC](https://community.folivora.ai/t/create-a-custom-hyper-key/42495/4 "2025-02-23T13:24:55Z")
Ok, if that's what someone wants, why not. I couldn't do without the right shift function. ๐Ÿคทโ€โ™‚๏ธ But I could imagine the following: - R shift pressed short, but long enough to type a capital letter (normal function). - And a little longer pressed and held, then presses the modifiers. ![image](https://community.folivora.ai/uploads/default/original/3X/f/c/fc869253bc995f6ceee4b8802ba6af590428baee.png) But yes, everyone as he needs it. ๐Ÿ™‚ ---
**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:** [February 23, 2025, 1:33pm UTC](https://community.folivora.ai/t/create-a-custom-hyper-key/42495/5 "2025-02-23T13:33:11Z")
Yep, I for example rarely use the right-shift key ๐Ÿ™‚ However this is just an example. You can remap any key you don't use exactly like this. ---
**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:** [February 23, 2025, 9:53pm UTC](https://community.folivora.ai/t/create-a-custom-hyper-key/42495/6 "2025-02-23T21:53:23Z")
Here is an other interesting example on what is possible with the recent improvements. Note, this requites 5.220. It remaps the enter key to a hyper key - but only if the right shift key is pressed first. As soon as you let go of the shift key, the enter key reverts to its standard behavior. Both right-shift and enter work as usual if they are pressed individually: [rightshift\_enter\_hyperkey3.bttpreset](https://community.folivora.ai/uploads/short-url/AgJQpaKwAzPCxClXiPBRxDnf0Nu.bttpreset) (10.4 KB) This is done by using a key sequence that triggers on shift-down, which then disables the enter key by remapping it to "no key". Then there are two more key sequences that make convert the disabled enter key into a hyper key. ---
**Author:** ![Sammy](https://community.folivora.ai/user_avatar/community.folivora.ai/sammy/32/40573_2.png) [@Sammy](https://community.folivora.ai/u/Sammy)\ **Post date:** [August 5, 2025, 8:35am UTC](https://community.folivora.ai/t/create-a-custom-hyper-key/42495/7 "2025-08-05T08:35:14Z")
Hi, I've followed your instruction above and try to remap my Tab as second hyper key (command + opt + shift). However, I cannot find an option to reset Tab key as simple tab (\t) in the Key Sequence setting. Could you help me out? ![image](https://community.folivora.ai/uploads/default/original/3X/5/9/59b71c0d6095e386bcfee7928c047b32761e8862.jpeg) ---
**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:** [August 5, 2025, 8:39am UTC](https://community.folivora.ai/t/create-a-custom-hyper-key/42495/8 "2025-08-05T08:39:40Z")
what do you mean by "reset tab"? ---
**Author:** ![Sammy](https://community.folivora.ai/user_avatar/community.folivora.ai/sammy/32/40573_2.png) [@Sammy](https://community.folivora.ai/u/Sammy)\ **Post date:** [August 5, 2025, 8:46am UTC](https://community.folivora.ai/t/create-a-custom-hyper-key/42495/9 "2025-08-05T08:46:36Z")
I want to use the short press Tab as a default "Tab" key. But I cannot find the "Tab" option in the drop down menu, and cannot type "tab" in "Click here to record a different shortcut". PS: From the image you can see I've disable the keyboard sequence before I try to type Tab in the "Click here to record a different shortcut". ![image](https://community.folivora.ai/uploads/default/original/3X/d/8/d84db5397e44179f4d6c9a2c9238b6a502aa36e4.png) ![image](https://community.folivora.ai/uploads/default/original/3X/7/c/7ce16bb97f0c3391252500e945bc16264c5c998f.jpeg) I cannot find the tab in this drop down menu. ---
**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:** [August 5, 2025, 8:49am UTC](https://community.folivora.ai/t/create-a-custom-hyper-key/42495/10 "2025-08-05T08:49:16Z")
To record a tab key you'd need to disable the remapping you created in "Automations, Named & Other Triggers" temporarily - possibly restart BTT after disabling it. ---
**Author:** ![Sammy](https://community.folivora.ai/user_avatar/community.folivora.ai/sammy/32/40573_2.png) [@Sammy](https://community.folivora.ai/u/Sammy)\ **Post date:** [August 5, 2025, 8:54am UTC](https://community.folivora.ai/t/create-a-custom-hyper-key/42495/11 "2025-08-05T08:54:07Z")
Yes! It work now, thank you for this wonderful app! ---
**Author:** ![nbook](https://community.folivora.ai/user_avatar/community.folivora.ai/nbook/32/40994_2.png) [@nbook](https://community.folivora.ai/u/nbook)\ **Post date:** [September 7, 2025, 6:25pm UTC](https://community.folivora.ai/t/create-a-custom-hyper-key/42495/12 "2025-09-07T18:25:02Z")
I followed this tutorial, in the latest version 5.593 this approach will make the program crash. The last version it doesn't crash is 5.540. Will you please kindly check what's going on? Environment: MBP macOS Sequoia 15.6.1 ---
**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:** [September 8, 2025, 7:59am UTC](https://community.folivora.ai/t/create-a-custom-hyper-key/42495/13 "2025-09-08T07:59:18Z")
where exactly did you get a crash? could you post the crashlog from the macOS console.appโ€˜s crash report section? ---
**Author:** ![nbook](https://community.folivora.ai/user_avatar/community.folivora.ai/nbook/32/40994_2.png) [@nbook](https://community.folivora.ai/u/nbook)\ **Post date:** [September 9, 2025, 6:36pm UTC](https://community.folivora.ai/t/create-a-custom-hyper-key/42495/14 "2025-09-09T18:36:28Z")
The crash happened when I release the hyper key (in my case right option). More details: It's a fresh install of BTT, no other configurations. Right option is mapped to no\_key, and the key sequence right\_option DOWN triggers ctrl, option, cmd, shift DOWN. I add a HUD and can tell this part works. And the key sequence right\_option UP triggers ctrl, option, cmd, shift UP. The program crashes as soon as I release the right option key. The same setting works on version 5.540 but not latter versions. I will share the crash report later. Thanks for your time! ---
**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:** [September 9, 2025, 6:40pm UTC](https://community.folivora.ai/t/create-a-custom-hyper-key/42495/15 "2025-09-09T18:40:41Z")
best copy & paste the key sequence that causes a crash for you, then I can check quickly! Does it still happen with 5.601? ([https://folivora.ai/releases/btt5.601-2025090904.zip](https://folivora.ai/releases/btt5.601-2025090904.zip)) ---
**Author:** ![nbook](https://community.folivora.ai/user_avatar/community.folivora.ai/nbook/32/40994_2.png) [@nbook](https://community.folivora.ai/u/nbook)\ **Post date:** [September 10, 2025, 5:41pm UTC](https://community.folivora.ai/t/create-a-custom-hyper-key/42495/16 "2025-09-10T17:41:39Z")
I've updated to 5.602 and the issue is fixed. Thank you for the quick response!