.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "PW-CONFIG" 1 "" "" "General Commands Manual"
.SH NAME
pw-config \- Debug PipeWire Config parsing
.SH SYNOPSIS
.nf
\fBpw\-config\fP [\fIoptions\fP] paths
.fi
.sp
.nf
\fBpw\-config\fP [\fIoptions\fP] list [\fISECTION\fP]
.fi
.sp
.nf
\fBpw\-config\fP [\fIoptions\fP] merge \fISECTION\fP
.fi
.sp
.SH DESCRIPTION
.sp
List config paths and config sections and display the parsed
output.
.sp
This tool can be used to get an overview of the config file that will be
parsed by the PipeWire server and clients.
.SH COMMON OPTIONS
.INDENT 0.0
.TP
.B \-h | \-\-help
Show help.
.UNINDENT
.INDENT 0.0
.TP
.B  \-\-version
Show version information.
.UNINDENT
.INDENT 0.0
.TP
.B \-n | \-\-name=NAME
Config Name (default \(aqpipewire.conf\(aq)
.TP
.B \-p | \-\-prefix=PREFIX
Config Prefix (default \(aq\(aq)
.TP
.B \-L | \-\-no\-newline
Omit newlines after values
.TP
.B \-r | \-\-recurse
Reformat config sections recursively
.TP
.B \-N | \-\-no\-colors
Disable color output
.TP
.B \-C | \-\-color[=WHEN]
whether to enable color support. WHEN is \fInever\fP, \fIalways\fP, or \fIauto\fP
.UNINDENT
.SH LISTING PATHS
.sp
Specify the paths command. It will display all the config files that will
be parsed and in what order.
.SH LISTING CONFIG SECTIONS
.sp
Specify the list command with an optional \fISECTION\fP to list the configuration
fragments used for \fISECTION\fP\&. Without a \fISECTION\fP, all sections will be
listed.
.sp
Use the \-r options to reformat the sections.
.SH MERGING A CONFIG SECTION
.sp
With the merge option and a \fISECTION\fP, 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.
.sp
Use the \-r options to reformat the sections.
.SH EXAMPLES
.INDENT 0.0
.TP
.B \fBpw\-config\fP
List all config files that will be used
.TP
.B \fBpw\-config\fP \-n pipewire\-pulse.conf
List all config files that will be used by the PipeWire pulseaudio server.
.TP
.B \fBpw\-config\fP \-n pipewire\-pulse.conf list
List all config sections used by the PipeWire pulseaudio server
.TP
.B \fBpw\-config\fP \-n jack.conf list context.properties
List the context.properties fragments used by the JACK clients
.TP
.B \fBpw\-config\fP \-n jack.conf merge context.properties
List the merged context.properties used by the JACK clients
.TP
.B \fBpw\-config\fP \-n pipewire.conf \-r merge context.modules
List the merged context.modules used by the PipeWire server and reformat
.UNINDENT
.SH AUTHORS
.sp
The PipeWire Developers <\fI\%https://gitlab.freedesktop.org/pipewire/pipewire/issues\fP>; PipeWire is available from \fI\%https://pipewire.org\fP
.SH SEE ALSO
.sp
\fBpipewire(1)\fP,
\fBpw\-dump(1)\fP,
.\" Generated by docutils manpage writer.
.
