Skip to content

microphone

Microphone input level and mute toggle.

Add it to your layout with microphone:

toml
[[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

toml
[[modules.microphone.thresholds]]
above = 70
icon-color = "status-warning"
label-color = "status-warning"

[[modules.microphone.thresholds]]
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"red"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"wayle 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

toml
[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 = "red"
label-max-length = 0
button-bg-color = "bg-surface-elevated"
left-click = "dropdown:audio"
right-click = ""
middle-click = "wayle audio input-mute"
scroll-up = ""
scroll-down = ""
thresholds = []

Released under the MIT License.