OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
audio-input low occasional DISPUTE

Stop held volume keys lagging and flooding pipewire-pulse on Omarchy 4

omarchyhyprlandpipewirelaptop
AUDITED Audited against its sources and confirmed accurate. · checked against Omarchy omarchy 4.0.4-1 on 2026-10-05
AUDIT NOTE

Issue #11784 (MacBookAir6,2, open) supports the symptom, the 40-per-second repeat and the nonblocking flock remedy, and its PR #11785, which serialises the adjustments, is still open. On this workstation /usr/share/omarchy/default/hypr/bindings/media.lua binds XF86AudioRaiseVolume and XF86AudioLowerVolume, plus the ALT precise variants with +1 and -1, as o.bind(..., { locked = true, repeating = true }). /usr/share/omarchy/default/hypr/input.lua sets repeat_rate = 40. /usr/share/omarchy/bin/omarchy-audio-output-volume calls omarchy-audio-output-sink, then pactl get-sink-volume, set-sink-mute, set-sink-volume and get-sink-volume again, then omarchy-osd, with no lock (only mute-toggle has a debounce), and it is identical to the quattro copy. The override shape (hl.unbind then o.bind in ~/.config/hypr/bindings.lua) is the one the shipped template /usr/share/omarchy/config/hypr/bindings.lua documents. o.bind wraps the string in hl.dsp.exec_cmd, so $XDG_RUNTIME_DIR is expanded by the shell. flock is in util-linux. omarchy-menu-keybindings accepts --print. Not exercised: the binding was not installed and no reload was run.

Symptom

Holding the volume up or down key makes the volume and the on-screen display lag behind, and the level keeps creeping after you let go. journalctl --user -fu pipewire-pulse.service shows bursts of pipewire-pulse: too many client application connections: Connection refused, dozens within a couple of seconds. Tapping the key works fine.

Cause

Omarchy 4 binds XF86AudioRaiseVolume and XF86AudioLowerVolume with repeating = true in /usr/share/omarchy/default/hypr/bindings/media.lua, and its input defaults set repeat_rate = 40, so a held key runs omarchy-audio-output-volume up to 40 times a second. Each run starts several short-lived pactl clients (resolving the sink through omarchy-audio-output-sink, reading the volume, unmuting, setting the volume, reading it again) and then calls omarchy-osd. On slower machines the runs overlap and exhaust pipewire-pulse's client connection limit, and the queued runs keep applying after release. Reported on a MacBookAir6,2. Confirmed on 4.0.4-1 by reading /usr/share/omarchy/bin/omarchy-audio-output-volume: it has no lock around the repeatable actions.

Fix

Override the two bindings in your personal file so that a repeat which arrives while the previous one is still running is dropped. flock -n exits immediately when the lock is held, and it is part of util-linux, which every Arch install has.


-- ~/.config/hypr/bindings.lua
hl.unbind("XF86AudioRaiseVolume")
hl.unbind("XF86AudioLowerVolume")
o.bind("XF86AudioRaiseVolume", "Volume up",
  'flock -n "$XDG_RUNTIME_DIR/omarchy-volume-repeat.lock" omarchy-audio-output-volume raise',
  { locked = true, repeating = true })
o.bind("XF86AudioLowerVolume", "Volume down",
  'flock -n "$XDG_RUNTIME_DIR/omarchy-volume-repeat.lock" omarchy-audio-output-volume lower',
  { locked = true, repeating = true })

If you use the precise ALT + XF86AudioRaiseVolume / ALT + XF86AudioLowerVolume bindings, override them the same way with +1 and -1. Mute is not repeating and needs no change.

Hyprland reloads the config when the file is saved. If it does not pick it up, run hyprctl reload yourself.

Plain Arch with a bare Hyprland: this does not apply to binds that call wpctl set-volume directly, because that is one native client per press.

Verify

Hold a volume key for three seconds while running journalctl --user -fu pipewire-pulse.service: no too many client application connections lines appear, and the level stops moving within a moment of releasing the key. omarchy menu keybindings --print | grep -i volume shows your descriptions.

Sources

omarchy-volume-key-hold-floods-pipewire-pulse