wpconfig(1)
SYNOPSIS
DESCRIPTION
wpconfig inspects WirePlumber's static configuration. It uses the same
file lookup, fragment loading, merging and override. rules as
WirePlumber. It does not connect to PipeWire or to a running WirePlumber
process.
With no command, wpconfig runs paths.
COMMANDS
paths
Print the absolute path of each successfully loaded configuration file in processing order. This includes readable empty files. Files that cannot be read or parsed are not included.
list
wpconfig list [SECTION]
Print original, unmerged section definitions as an array. Each item contains
section.name, section.location and section.value. Repeated section
names remain separate and retain configuration load order.
When SECTION is given, show only definitions that contribute to that logical
section. For example, list foo includes both foo and override.foo
definitions while preserving their source names.
merge
wpconfig merge [SECTION]
With SECTION, print its effective value after applying WirePlumber's normal merge rules.
Without SECTION, print one top-level object containing every logical section
exactly once. Section names have no synthetic override. prefix, and each
value is obtained through the same merge operation used by WirePlumber.
OPTIONS
- -h, --help
Show command help and exit.
- -V, --version
Show the tool, compile-time and linked WirePlumber versions and exit.
- -n NAME, --name=NAME
Select the configuration filename. The default is
wireplumber.conf. An absolute filename uses the normal absolute-path behavior of WirePlumber's configuration lookup.- -L, --no-newline
Use compact output without formatting newlines between values.
- -r, --recurse
Recursively reformat nested JSON containers.
- -N, --no-colors
Disable ANSI colors.
- -C[WHEN], --color[=WHEN]
Control ANSI colors. WHEN is
auto,alwaysornever. The default isauto.- -s, --spa
Use SPA JSON style, including
=between object keys and values and no comma separators.
ENVIRONMENT
- WIREPLUMBER_CONFIG_DIR
Select an alternate WirePlumber configuration directory using the standard WirePlumber lookup rules.
- NO_COLOR
Disable automatic color output when this variable is present. An explicit
--color=alwaysoverrides it.- WIREPLUMBER_DEBUG
Set WirePlumber library logging. Without this variable, wpconfig only enables warning and error diagnostics.
EXAMPLES
List the files that make up the default configuration:
wpconfig paths
Show every source definition of an ALSA rules section:
wpconfig -r list monitor.alsa.rules
Show the effective ALSA rules section:
wpconfig -r merge monitor.alsa.rules
Show the complete effective configuration in compact SPA JSON form:
wpconfig -s -r -L merge
Inspect a configuration by absolute filename:
wpconfig -n /tmp/wireplumber.conf merge
EXIT STATUS
- 0
Success.
- 1
Configuration loading, output or internal data processing failed.
- 2
Command-line usage error.
SEE ALSO
wireplumber(1), wpctl(1), pw-config(1)
WirePlumber Documentation: https://pipewire.pages.freedesktop.org/wireplumber/