mirror of
https://gitlab.freedesktop.org/pipewire/pipewire
synced 2024-09-20 00:11:31 +00:00
e41187d643
xmltoman looks dead and uses XML as well as pulls in a long list of Perl dependencies. This replaces it with rst2man that has almost no dependencies beyond Python, which is already required for the Meson build system. Naturally rst2man uses reStructuredText and the pages were rewritten via regex and manual editing to be as close to original XML format as possible. A few fixes and updates were done too. Most notably a note was added to indicate that production deployments should not be starting the session manager via pipewire.conf file. There's three slight formatting issues/differences: 1. rst2man produces simpler footer. 2. "-f | --foo=value" confuses the parser and it fails to correctly add argument specific syntax highlighting to assignment value. 3. XML version had inconsistent use of <arg> and <opt> which has been partially addressed. But different manual pages still have their differences to what and how is highlighted.
92 lines
2.5 KiB
ReStructuredText
92 lines
2.5 KiB
ReStructuredText
.. This file is part of PipeWire.
|
|
|
|
pipewire.conf
|
|
#############
|
|
|
|
--------------------------------------
|
|
The PipeWire server configuration file
|
|
--------------------------------------
|
|
|
|
:Manual section: 5
|
|
:Manual group: File Formats Manual
|
|
|
|
.. _synopsis:
|
|
|
|
SYNOPSIS
|
|
========
|
|
|
|
*$XDG_CONFIG_HOME/pipewire/pipewire.conf*
|
|
|
|
*@PIPEWIRE_CONFIG_DIR@/pipewire.conf*
|
|
|
|
*@PIPEWIRE_CONFDATADIR@/pipewire.conf*
|
|
|
|
DESCRIPTION
|
|
===========
|
|
|
|
PipeWire is a service that facilitates sharing of multimedia content
|
|
between devices and applications.
|
|
|
|
On startup, the daemon reads a configuration file to configure
|
|
itself. It executes a series of commands listed in the config
|
|
file.
|
|
|
|
The config files are loaded in the order listed in the SYNOPSIS_.
|
|
The environment variables ``PIPEWIRE_CONFIG_DIR``, ``PIPEWIRE_CONFIG_PREFIX``
|
|
and ``PIPEWIRE_CONFIG_NAME`` can be used to specify an alternative config
|
|
directory, subdirectory and file respectively.
|
|
|
|
CONFIGURATION FILE FORMAT
|
|
=========================
|
|
|
|
The configuration file format is grouped into sections. A section
|
|
is either a dictionary, {}, or an array, []. Dictionary and array
|
|
entries are separated by whitespace and may be simple value
|
|
assignment, an array or a dictionary. For example:
|
|
|
|
name = value # simple assignment
|
|
|
|
name = { key1 = value1 key2 = value2 } # a dictionary with two
|
|
entries
|
|
|
|
name = [ value1 value2 ] # an array with two entries
|
|
|
|
name = [ { k = v1 } { k = v2 } ] # an array of dictionaries
|
|
|
|
CONFIGURATION FILE SECTIONS
|
|
===========================
|
|
|
|
context.properties
|
|
Dictionary. These properties configure the PipeWire instance.
|
|
|
|
context.spa-libs
|
|
Dictionary. Maps plugin features with globs to a spa library.
|
|
|
|
context.modules
|
|
Array of dictionaries. Each entry in the array is a dictionary with the *name* of the module to load,
|
|
including optional *args* and *flags*. Most modules support being loaded
|
|
multiple times.
|
|
|
|
context.objects
|
|
Array of dictionaries. Each entry in the array is a dictionary containing the *factory* to create an
|
|
object from and optional extra arguments specific to that factory.
|
|
|
|
context.exec
|
|
Array of dictionaries. Each entry in the array is dictionary containing the *path* of a program to
|
|
execute on startup and optional *args*.
|
|
|
|
This array used to contain an entry to start the session manager but this mode
|
|
of operation has since been demoted to development aid. Avoid starting a
|
|
session manager in this way in production environment.
|
|
|
|
AUTHORS
|
|
=======
|
|
|
|
The PipeWire Developers <@PACKAGE_BUGREPORT@>; PipeWire is available from @PACKAGE_URL@
|
|
|
|
SEE ALSO
|
|
========
|
|
|
|
``pipewire(1)``,
|
|
``pw-mon(1)``,
|