Skip to content

bluetooth

Bluetooth connection status with a dropdown for pairing and managing devices.

Add it to your layout with bluetooth:

toml
[[bar.layout]]
monitor = "*"
right = ["bluetooth"]

General

FieldTypeDefaultDescription
disabled-iconstring"ld-bluetooth-off-symbolic"Icon when Bluetooth is disabled or unavailable.
disconnected-iconstring"ld-bluetooth-symbolic"Icon when Bluetooth is on but no devices connected.
connected-iconstring"ld-bluetooth-connected-symbolic"Icon when devices are connected.
searching-iconstring"ld-bluetooth-searching-symbolic"Icon when scanning for devices.
border-showboolfalseDisplay border around button.
icon-showbooltrueDisplay module icon.
label-showbooltrueDisplay connection label (device name or count).
label-max-lengthu3215Max label characters before truncation with ellipsis. Set to 0 to disable.

Colors

FieldTypeDefaultDescription
border-colorColorValue"blue"Border color token.
icon-colorColorValue"auto"Icon foreground color. Auto selects based on variant for contrast.
icon-bg-colorColorValue"blue"Icon container background color token.
label-colorColorValue"blue"Label text color token.
button-bg-colorColorValue"bg-surface-elevated"Button background color token.

Click actions

FieldTypeDefaultDescription
left-clickClickAction"dropdown:bluetooth"Action on left click.
right-clickClickAction""Action on right click.
middle-clickClickAction""Action on middle click.
scroll-upClickAction""Action on scroll up.
scroll-downClickAction""Action on scroll down.

Default configuration

toml
[modules.bluetooth]
disabled-icon = "ld-bluetooth-off-symbolic"
disconnected-icon = "ld-bluetooth-symbolic"
connected-icon = "ld-bluetooth-connected-symbolic"
searching-icon = "ld-bluetooth-searching-symbolic"
border-show = false
border-color = "blue"
icon-show = true
icon-color = "auto"
icon-bg-color = "blue"
label-show = true
label-color = "blue"
label-max-length = 15
button-bg-color = "bg-surface-elevated"
left-click = "dropdown:bluetooth"
right-click = ""
middle-click = ""
scroll-up = ""
scroll-down = ""

Released under the MIT License.