pw-config - Man Page

Debug PipeWire Config parsing

Examples (TL;DR)

List all configuration files that will be used: pw-config
List all configuration files that will be used by the PipeWire PulseAudio server: pw-config --name pipewire-pulse.conf
List all configuration sections used by the PipeWire PulseAudio server: pw-config --name pipewire-pulse.conf list
List the context.properties fragments used by the JACK clients: pw-config --name jack.conf list context.properties
List the merged context.properties used by the JACK clients: pw-config --name jack.conf merge context.properties
List the merged context.modules used by the PipeWire server and [r]eformat: pw-config --name pipewire.conf --recurse merge context.modules
Display help: pw-config --help

tldr.sh

Synopsis

pw-config [options] paths

pw-config [options] list [SECTION]

pw-config [options] merge SECTION

Description

List config paths and config sections and display the parsed output.

This tool can be used to get an overview of the config file that will be parsed by the PipeWire server and clients.

Common Options

-h | --help: Show help.
--version: Show version information.
-n | --name=NAME: Config Name (default 'pipewire.conf')
-p | --prefix=PREFIX: Config Prefix (default '')
-L | --no-newline: Omit newlines after values
-r | --recurse: Reformat config sections recursively
-N | --no-colors: Disable color output
-C | -color[=WHEN]: whether to enable color support. WHEN is never, always, or auto

Listing Paths

Specify the paths command. It will display all the config files that will be parsed and in what order.

Listing Config Sections

Specify the list command with an optional SECTION to list the configuration fragments used for SECTION. Without a SECTION, all sections will be listed.

Use the -r options to reformat the sections.

Merging a Config Section

With the merge option and a SECTION, pw-config will merge all config files into a merged config section and dump the results. This will be the section used by the client or server.

Use the -r options to reformat the sections.

Examples

pw-config: List all config files that will be used
pw-config -n pipewire-pulse.conf: List all config files that will be used by the PipeWire pulseaudio server.
pw-config -n pipewire-pulse.conf list: List all config sections used by the PipeWire pulseaudio server
pw-config -n jack.conf list context.properties: List the context.properties fragments used by the JACK clients
pw-config -n jack.conf merge context.properties: List the merged context.properties used by the JACK clients
pw-config -n pipewire.conf -r merge context.modules: List the merged context.modules used by the PipeWire server and reformat