Manpage logo

libpipewire-module-example-filter - Example Filter

NAME  DESCRIPTION  MODULE NAME  MODULE OPTIONS  GENERAL OPTIONS  EXAMPLE CONFIGURATION OF A VIRTUAL SOURCE 

NAME

libpipewire-module-example-filter − Example Filter

DESCRIPTION

The example filter is a good starting point for writing a custom filter. We refer to the source code for more information.

MODULE NAME

libpipewire-module-example-filter

MODULE OPTIONS

•

node.description: a human readable name for the filter streams

•

capture.props = {}: properties to be passed to the input stream

•

playback.props = {}: properties to be passed to the output stream

GENERAL OPTIONS

Options with well-known behavior. Most options can be added to the global configuration or the individual streams:

•

remote.name

•

audio.rate

•

audio.channels

•

audio.position

•

media.name

•

node.latency

•

node.description

•

node.group

•

node.link.group

•

node.virtual

•

node.name : See notes below. If not specified, defaults to ’filter-PID-MODULEID’.

Stream only properties:

•

media.class

•

node.name : if not given per stream, the global node.name will be prefixed with ’input.’ and ’output.’ to generate a capture and playback stream node.name respectively.

EXAMPLE CONFIGURATION OF A VIRTUAL SOURCE

# ˜/.config/pipewire/pipewire.conf.d/my−example−filter.conf

context.modules = [
{ name = libpipewire−module−example−filter
args = {
node.description = "Example Filter"
capture.props = {
audio.position = [ FL FR ]
node.passive = true
}
playback.props = {
node.name = "Example Filter"
media.class = "Audio/Source"
audio.position = [ FL FR ]
}
}
}
]

pw−cli −m lm libpipewire−module−example−filter ’{ audio.position=[FL FR] }’


Updated 2026-06-01 - jenkler.se | uex.se