#pipewire #volume

app pw-volume

Basic interface to PipeWire volume controls

1 unstable release

0.4.0 Jul 23, 2022

#882 in Command line utilities

MIT license

46KB
340 lines

pw-volume

Basic interface to PipeWire volume controls

USAGE:
    pw-volume <SUBCOMMAND>

OPTIONS:
    -h, --help    Prints help information

SUBCOMMANDS:
    change    adjusts volume by decimal percentage, e.g. '+1%', '-0.5%'
    mute      mutes audio [possible values: on, off, toggle]
    status    get volume and mute information

Example Usage

Sway

You can use pw-volume to bind multimedia keys to raise, lower, and mute volume. For instance, in Sway's config:

bindsym XF86AudioRaiseVolume exec "pw-volume change +2.5%; pkill -RTMIN+8 waybar"
bindsym XF86AudioLowerVolume exec "pw-volume change -2.5%; pkill -RTMIN+8 waybar"
bindsym XF86AudioMute exec "pw-volume mute toggle; pkill -RTMIN+8 waybar"

Waybar

"custom/pipewire": {
    "exec": "pw-volume status",
    "return-type": "json",
    "interval": "once",
    "signal": 8,
    "format": "{icon} {percentage}",
    "format-icons": {
        "mute": "",
        "default": ["󰕿", "󰖀", "󰕾"]
    }
},

Dependencies

~1.6–2.5MB
~49K SLoC