Skip to content

custom_button

Shows a custom glyph/image and an optional label. What it does on click and scroll is set with widget actions.

SettingTypeDefaultDescription
glyphstring"heart"Bar glyph name: Noctalia alias, Tabler icon name, or U+ / 0x codepoint
custom_imagestring""Path to a custom image displayed instead of the glyph. Leave empty to use the glyph
custom_image_colorizeboolfalseWhen true, tint the custom image with the widget icon color
labelstring""Optional text label shown next to the glyph or image
glyph_positionstring"before"Place the glyph or image "before" or "after" the label. See Peek
peekboolfalseShow only the glyph or image and reveal the label on hover. See Peek
peek_delay_msint100Hover time before the label reveals, from 0 to 2000 ms
tooltipstring""Optional hover tooltip
[widget.quick-action]
type = "custom_button"
custom_image = "/path/to/icon.png"
custom_image_colorize = true
label = "Action"
[widget.quick-action.actions]
left = "exec notify-send Noctalia"
right = "exec notify-send 'Other action'"