Skip to content

bluetooth ​

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

Add it to your layout with bluetooth:

yaml
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"fg-default"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 ​

yaml
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: fg-default
    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.