Skip to content

microphone ​

Microphone input level and mute toggle.

Add it to your layout with microphone:

yaml
bar:
  layout:
    - monitor: "*"
      right: [microphone]

General ​

FieldTypeDefaultDescription
icon-activestring"ld-mic-symbolic"Icon shown when microphone is active (unmuted).
icon-mutedstring"ld-mic-off-symbolic"Icon shown when microphone is muted.
border-showboolfalseDisplay border around button.
icon-showbooltrueDisplay module icon.
label-showbooltrueDisplay percentage label.
label-max-lengthu320Max label characters before truncation with ellipsis. Set to 0 to disable.
thresholdsarray of ThresholdEntry[]Dynamic color thresholds based on microphone volume percentage.
More about thresholds

Entries are checked in order; the last matching entry wins for each color slot. Use above for high-value warnings (e.g., high input gain).

Example ​

yaml
modules:
  microphone:
    thresholds:
      - above: 70
        icon-color: status-warning
        label-color: status-warning
      - above: 90
        icon-color: status-error
        label-color: status-error

Colors ​

FieldTypeDefaultDescription
border-colorColorValue"red"Border color token.
icon-colorColorValue"auto"Icon foreground color. Auto selects based on variant for contrast.
icon-bg-colorColorValue"red"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:audio"Action on left click.
right-clickClickAction""Action on right click.
middle-clickClickAction"lys-shell audio input-mute"Action on middle click. Default toggles input mute.
scroll-upClickAction""Action on scroll up.
scroll-downClickAction""Action on scroll down.

Default configuration ​

yaml
modules:
  microphone:
    icon-active: ld-mic-symbolic
    icon-muted: ld-mic-off-symbolic
    border-show: false
    border-color: red
    icon-show: true
    icon-color: auto
    icon-bg-color: red
    label-show: true
    label-color: fg-default
    label-max-length: 0
    button-bg-color: bg-surface-elevated
    left-click: dropdown:audio
    right-click: ""
    middle-click: lys-shell audio input-mute
    scroll-up: ""
    scroll-down: ""
    thresholds: []

Released under the MIT License.