snippetbashTip

wpctl — Manage WirePlumber, a session and policy manager for PipeWire. Note: You can use the special name `@

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

commandwireplumberandclimanagepolicysessionwpctl

linux

Problem

How to use the wpctl command: Manage WirePlumber, a session and policy manager for PipeWire. Note: You can use the special name @DEFAULT_SINK@ in place of id to operate on the default sink. See also: pw-cli. More information: <https://pipewire.pages.freedesktop.org/wireplumber/>.

Solution

wpctl — Manage WirePlumber, a session and policy manager for PipeWire. Note: You can use the special name @DEFAULT_SINK@ in place of id to operate on the default sink. See also: pw-cli. More information: <https://pipewire.pages.freedesktop.org/wireplumber/>.

List all objects managed by WirePlumber:

wpctl status

Print all properties of an object:

wpctl inspect {{id}}

Set an object to be the default in its group:

wpctl set-default {{id}}

Get the volume of a sink:

wpctl get-volume {{id}}

Set the volume of a sink to n percent:

wpctl set-volume {{id}} {{n}}%

Increase/Decrease the volume of a sink by n percent:

wpctl set-volume {{id}} {{n}}%{{+|-}}

Increase the volume of a sink by n percent but limit the volume below 100%:

wpctl set-volume {{[-l|--limit]}} 1 {{id}} {{n}}%-

Mute/Unmute a sink (1 is mute, 0 is unmute):

wpctl set-mute {{id}} {{1|0|toggle}}

Code Snippets

List all objects managed by WirePlumber

wpctl status

Print all properties of an object

wpctl inspect {{id}}

Set an object to be the default in its group

wpctl set-default {{id}}

Get the volume of a sink

wpctl get-volume {{id}}

Set the volume of a sink to `n` percent

wpctl set-volume {{id}} {{n}}%

Context

tldr-pages: linux/wpctl

Revisions (0)

No revisions yet.