How to customize HUD?

Anurag_Kashyap · February 10, 2026, 8:53pm

I want to customize shape, size, position, background color, text color, emoji or SF symbol or png image- is there any way

Currently, it look like this

Andreas_Hegenberg · February 10, 2026, 8:57pm

you can use the predefined action "show hud", it offers more options!

Anurag_Kashyap · February 10, 2026, 9:01pm

can i change its shape? from square to rectangle or circle?

Andreas_Hegenberg · February 10, 2026, 9:05pm

no that is not possible, if you want full control you can set up some floating menu with the style you need and show that using the predefined action "show floating menu", then hide it again after some delay

Anurag_Kashyap · February 10, 2026, 9:25pm

is there a way so that the text not stick to bottom of hud overlay box and can be in vertically centre

Andreas_Hegenberg · February 10, 2026, 9:29pm

that's the default (unless you add some empty lines above)

Anurag_Kashyap · February 10, 2026, 9:31pm

I am getting this, the text won’t center vertically. (v6.176) (no empty lines there)

HUD Width 135
HUD Height 50

Text size 18

font Arial

Andreas_Hegenberg · February 10, 2026, 9:33pm

works fine here

Are you sure you don't have an empty line above the copied link text? (Best copy & paste the HUD json here, then I can test)

Anurag_Kashyap · February 10, 2026, 9:39pm

how to get that?

Andreas_Hegenberg · February 10, 2026, 9:39pm

select & cmd+c (or right-click => copy)

Anurag_Kashyap · February 10, 2026, 9:40pm

[
{
"BTTIsPureAction" : true,
"BTTPredefinedActionType" : 254,
"BTTPredefinedActionName" : "Show HUD Overlay",
"BTTHUDActionConfiguration" : "{"BTTIconConfigImageHeight":25,"BTTIconConfigIconType":1,"BTTActionHUDDisplayToUse":0,"BTTActionHUDOffsetX":0,"BTTIconConfigImage":null,"BTTActionHUDTitle":"","BTTIconConfigSFSymbolStyle":2,"BTTActionHUDDetail":"","BTTActionHUDDuration":1,"BTTIconConfigSFSymbolName":"link","BTTActionHUDHideWhenOtherHUDAppears":false,"BTTIconConfigIconColor1":"122.000000, 174.000005, 61.000000, 255.000000","BTTActionHUDBlur":true,"BTTActionHUDOffsetY":0,"BTTActionHUDHeight":50,"BTTActionHUDBackground":"0.000000, 0.000000, 0.000000, 0.000000","BTTActionHUDAttributedTitle":"{\\rtf1\\ansi\\ansicpg1252\\cocoartf2822\n\\cocoatextscaling0\\cocoaplatform0{\\fonttbl\\f0\\fswiss\\fcharset0 ArialMT;}\n{\\colortbl;\\red255\\green255\\blue255;\\red0\\green0\\blue0;}\n{\\*\\expandedcolortbl;;\\cssrgb\\c0\\c0\\c0;}\n\\pard\\tx560\\tx1120\\tx1680\\tx2240\\tx2800\\tx3360\\tx3920\\tx4480\\tx5040\\tx5600\\tx6160\\tx6720\\pardirnatural\\qc\\partightenfactor0\n\n\\f0\\fs36 \\cf2 \\uc0\\u9989 Copied Link}","BTTActionHUDSlideDirection":0,"BTTActionHUDBorderWidth":0,"BTTIconConfigIconColor2":null,"BTTIconConfigResizeImage":0,"BTTIconConfigImageWidth":10,"BTTActionHUDPosition":0,"BTTIconConfigIconColor3":null,"BTTActionHUDWidth":135}",
"BTTOrder" : 116
}
]

Andreas_Hegenberg · February 10, 2026, 9:45pm

Ah it got confused because a sfsymbol name was entered, try to paste this:

[
  {
    "BTTIsPureAction" : true,
    "BTTPredefinedActionType" : 254,
    "BTTPredefinedActionName" : "Show HUD Overlay",
    "BTTHUDActionConfiguration" : "{\"BTTIconConfigImageHeight\":25,\"BTTIconConfigIconType\":1,\"BTTActionHUDDisplayToUse\":0,\"BTTActionHUDOffsetX\":0,\"BTTIconConfigImage\":null,\"BTTActionHUDTitle\":\"\",\"BTTIconConfigSFSymbolStyle\":2,\"BTTActionHUDDetail\":\"\",\"BTTActionHUDDuration\":1,\"BTTActionHUDHideWhenOtherHUDAppears\":false,\"BTTIconConfigIconColor1\":\"122.000000, 174.000005, 61.000000, 255.000000\",\"BTTActionHUDBlur\":true,\"BTTActionHUDOffsetY\":0,\"BTTActionHUDHeight\":50,\"BTTActionHUDBackground\":\"0.000000, 0.000000, 0.000000, 0.000000\",\"BTTActionHUDAttributedTitle\":\"{\\\\rtf1\\\\ansi\\\\ansicpg1252\\\\cocoartf2822\\n\\\\cocoatextscaling0\\\\cocoaplatform0{\\\\fonttbl\\\\f0\\\\fswiss\\\\fcharset0 ArialMT;}\\n{\\\\colortbl;\\\\red255\\\\green255\\\\blue255;\\\\red0\\\\green0\\\\blue0;}\\n{\\\\*\\\\expandedcolortbl;;\\\\cssrgb\\\\c0\\\\c0\\\\c0;}\\n\\\\pard\\\\tx560\\\\tx1120\\\\tx1680\\\\tx2240\\\\tx2800\\\\tx3360\\\\tx3920\\\\tx4480\\\\tx5040\\\\tx5600\\\\tx6160\\\\tx6720\\\\pardirnatural\\\\qc\\\\partightenfactor0\\n\\n\\\\f0\\\\fs36 \\\\cf2 \\\\uc0\\\\u9989  Copied Link}\",\"BTTActionHUDSlideDirection\":0,\"BTTActionHUDBorderWidth\":0,\"BTTIconConfigIconColor2\":null,\"BTTIconConfigResizeImage\":0,\"BTTIconConfigImageWidth\":10,\"BTTActionHUDPosition\":0,\"BTTIconConfigIconColor3\":null,\"BTTActionHUDWidth\":135}",
    "BTTOrder" : 1
  }
]

Anurag_Kashyap · February 10, 2026, 10:22pm

thanks!! made a copy Link extension replacement

Uses apple script (blocking) to copy current tab url to clipboard and a pill shaped HUD in top right

copy link brave chrome safari.bttpreset (4.9 KB)

Anurag_Kashyap · February 11, 2026, 6:06am

@Andreas_Hegenberg Is there a way to stop retriggering same action, if keys pressed twice or thrice, I want if previous action is going on- don’t trigger same again in meanwhile?

I have a keyboard shortcut to trigger applescript that to custom ocr with cleanshot x

turning on recursive trigger- make me 1 ocr at a time, but it keep popping (is it a bug?)

Andreas_Hegenberg · February 11, 2026, 8:03am

If you generally don't want keyboard shortcuts sent by BTT to trigger BTT shortcuts you can enable this option:

Otherwise you can add the "Ignore / Disable Trigger Actions For X Seconds" action at the beginning of your action sequence:

ByteCurious · September 26, 2026, 2:18pm

It would be amazing if there's a way to just simply change the HUD settings such as font size, box size, and box opacity and its a global setting that can be found under the BTT Settings menu.

Since the HUD feature already exist, creating a floating menu to get around the current HUD limitations might be too advance for basic users.

Andreas_Hegenberg · September 26, 2026, 2:22pm

you can via the “show hud” action

ByteCurious · September 26, 2026, 2:31pm

OMG Yes! Amazing. Thank you! did not know that even existed.