pipewire-pulse-modules.7

pipewire-pulse-modules

NAME
DESCRIPTION
LOADING MODULES
COMMON MODULE OPTIONS
BUILT-IN MODULES
AUTHORS
SEE ALSO

---

NAME

pipewire-pulse-modules − PipeWire Pulseaudio modules

DESCRIPTION

PipeWire’s Pulseaudio emulation implements several Pulseaudio modules. It only supports its own built-in modules, and cannot load external modules written for Pulseaudio.

LOADING MODULES

The built-in modules can be loaded using Pulseaudio client programs, for example pactl load-module <module-name> <module-options>. They can also added to pipewire-pulse.conf, typically by a drop-in file in ~/.config/pipewire/pipewire-pulse.conf.d/ containing the module name and its arguments

~/.config/pipewire/pipewire−pulse.conf.d/custom.conf

pulse.cmd = [
{ cmd = “load−module” args = “module−null−sink sink_name=foo” flags = [ ] }
]

To list all modules currently loaded, with their arguments:

pactl list modules

For a short list of loaded modules:

pactl list modules short

Modules may be unloaded using either the module-name or index number:

pactl load−module <module−name> <parameters>
pactl unload−module <module−name|index#>

COMMON MODULE OPTIONS

Most modules that create streams/devices support the following properties:

sink_name, source_name

Name for the sink (resp. source). Allowed characters in the name are a-z, A-Z, numbers, period (.) and underscore (_). The length must be 1-128 characters.

format

The sample format. The supported audio formats are:

PCM

Compressed audio formats

Below is a list of all supported compressed formats. The code at the beginning of each line is used whenever a textual identifier for a format is needed (for example in configuration files or on the command line). The formats whose identifier ends with -iec61937 have to be wrapped in IEC 61937 frames, which makes the compressed audio behave more like normal PCM audio.

rate

The sample rate.

channels

Number of audio channels.

channel_map

A channel map. A list of comma-separated channel names. The currently defined channel names are: left, right, mono, center, front-left, front-right, front-center, rear-center, rear-left, rear-right, lfe, subwoofer, front-left-of-center, front-right-of-center, side-left, side-right, aux0, aux1 to aux15, top-center, top-front-left, top-front-right, top-front-center, top-rear-left, top-rear-right, top-rear-center

sink_properties, source_properties

Set additional properties of the sink/source. For example, you can set the description directly when the module is loaded by setting this parameter.

load−module module−alsa−sink sink_name=headphones sink_properties=device.description=Headphones

BUILT-IN MODULES

AUTHORS

The PipeWire Developers <https://gitlab.freedesktop.org/pipewire/pipewire/issues>; PipeWire is available from <https://pipewire.org>

SEE ALSO

pipewire-pulse(1)

---