WPCTL(1) WirePlumber WPCTL(1) (NAME) wpctl - WirePlumber (SYNOPSIS) wpctl [COMMAND] [COMMAND_OPTIONS] (DESCRIPTION) wpctl WirePlumber PipeWire . (nodes) PipeWire . WirePlumber . wpctl . (COMMANDS) status wpctl status [-k|--nick] [-n|--name] PipeWire (sinks) (sources) (streams) . / . : -k, --nick (nickname) -n, --name list wpctl list [audio|video] [devices|sinks|sources] PipeWire . : (ID) / *. : audio|video () devices|sinks|sources () ( ) wpctl get-volume ID (mute) . : ID (Node ID) ( << >> (SPECIAL IDENTIFIERS) ) inspect wpctl inspect ID [-r|--referenced] [-a|--associated] . : ID : -r, --referenced -a, --associated set-default wpctl set-default ID ( ) . default-nodes <#state-locations> WirePlumber . clear-default . : ID sink source set-volume wpctl set-volume ID VOL[%][-|+] [-p|--pid] [-l LIMIT|--limit LIMIT] . : ID PID ( --pid) VOL[%][-|+] : o VOL - (1.0 = 100%) o VOL% - (50% = 0.5) o VOL+ - o VOL- - o VOL%+ - o VOL%- - : -p, --pid ID (PID) -l LIMIT, --limit LIMIT ( 1.0 = 100%) : 50%: wpctl set-volume @DEFAULT_SINK@ 0.5 10%: wpctl set-volume 42 10%+ PID 1234: wpctl set-volume --pid 1234 0.8 wpctl set-mute ID 1|0|toggle [-p|--pid] . : ID (Node ID) PID ( --pid) 1|0|toggle : 1 () 0 () (toggle) : -p, --pid ID set-profile wpctl set-profile ID INDEX . : ID INDEX ( 0 'off' ) set-route wpctl set-route ID INDEX (route) . : ID INDEX ( 0 'off' ) clear-default wpctl clear-default [ID] . . set-default WirePlumber priority.session . . "Default Configured Devices" status . : ID () (0-2 Audio/Sink Audio/Source Video/Source). . wpctl settings [KEY] [VAL] [-d|--delete] [-s|--save] [-r|--reset] WirePlumber . : KEY () VAL () ( JSON) : -d, --delete ( KEY ) -s, --save ( KEY VAL ) -r, --reset : o : o KEY: o KEY VAL: set-log-level wpctl set-log-level [ID] LEVEL () . : ID () . WirePlumber . PipeWire 0 . LEVEL ( 0 1 2 3 4 5 E W N I D T). - . reset wpctl reset [-c|--wireplumber-config] [-p|--pipewire-config] [-a|--all] [-n|--no-restart] [-d|--dry-run] [-y|--yes] WirePlumber ( PipeWire) . WirePlumber (~/.local/state/wireplumber) . WirePlumber --no-restart . --yes . PipeWire . : -c, --wireplumber-config WirePlumber (~/.config/wireplumber) -p, --pipewire-config PipeWire (~/.config/pipewire) PipeWire -a, --all ( -c -p) -n, --no-restart -d, --dry-run -y, --yes wpctl : @DEFAULT_SINK@ @DEFAULT_AUDIO_SINK@ ( ) @DEFAULT_SOURCE@ @DEFAULT_AUDIO_SOURCE@ ( ) @DEFAULT_VIDEO_SOURCE@ () . (EXIT STATUS) wpctl : 0 1 ( ) 2 PipeWire 3 ( ) (EXAMPLES) : wpctl status : wpctl set-default 42 75% : wpctl set-volume @DEFAULT_SINK@ 75% 5% : wpctl set-volume 42 5%+ : wpctl set-mute @DEFAULT_SOURCE@ 1 : wpctl set-mute @DEFAULT_SINK@ toggle : wpctl inspect --associated 30 WirePlumber: wpctl settings : wpctl settings bluetooth.autoswitch true : wpctl settings --save WirePlumber debug: wpctl set-log-level D : wpctl set-log-level 42 W : wpctl list audio sinks WirePlumber ( ): wpctl reset --dry-run WirePlumber : wpctl reset --wireplumber-config --yes ( WirePlumber PipeWire): wpctl reset --all (NOTES) status . . 1.0 . (amplification) 1.0 . --pid wpctl . (SEE ALSO) wireplumber(1), wpexec(1), pipewire(1), pw-cli(1), pw-dump(1) WirePlumber: (AUTHORS) WirePlumber (COPYRIGHT) 2020-2025, Collabora & contributors 0.5.17 September 3, 2026 WPCTL(1)