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
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'"