libpipewire-module-parametric-equalizer(7)

NAME
libpipewire-module-parametric-equalizer - Parametric-Equalizer

DESCRIPTION

The parametric-equalizer module loads parametric equalizer configuration generated from the AutoEQ project or Squiglink.

Both the projects allow equalizing headphones or an in-ear monitor to a target curve. While these generate a file for parametric equalization for a given target, but this is not a format that can be directly given to filter chain module.

A popular example of the above being EQ'ing to the Harman target curve or EQ'ing one headphone/IEM to another.

For AutoEQ, see https://github.com/jaakkopasanen/AutoEq. For SquigLink, see https://squig.link/.

Parametric equalizer configuration generated from AutoEQ or Squiglink looks like below.

Preamp: -6.8 dB
Filter 1: ON PK Fc 21 Hz Gain 6.7 dB Q 1.100
Filter 2: ON PK Fc 85 Hz Gain 6.9 dB Q 3.000
Filter 3: ON PK Fc 110 Hz Gain -2.6 dB Q 2.700
Filter 4: ON PK Fc 210 Hz Gain 5.9 dB Q 2.100
Filter 5: ON PK Fc 710 Hz Gain -1.0 dB Q 0.600
Filter 6: ON PK Fc 1600 Hz Gain 2.3 dB Q 2.700

Fc, Gain and Q specify the frequency, gain and Q factor respectively. The fourth column can be one of PK, LSC or HSC specifying peaking, low shelf and high shelf filter respectively. More often than not only peaking filters are involved.

This module parses a configuration like above and loads the filter chain module with the above configuration translated to filter chain arguments.

MODULE NAME

libpipewire-module-parametric-equalizer

MODULE OPTIONS

Options specific to the behaviour of this module

•   equalizer.filepath = <str> path of the file with parametric EQ

•   equalizer.description = <str>: Name which will show up in

•   audio.channels = <int>: Number of audio channels, default 2

•   audio.position = <str>: Channel map, default "[FL, FR]"

•   remote.name = <str>: environment with remote name, default "pipewire-0"

•   capture.props = {}: properties passed to the input stream, default { media.class = "Audio/Sink", node.name = "effect_input.eq<number of nodes>" }

•   playback.props = {}: properties passed to the output stream, default { node.passive = true, node.name = "effect_output.eq<number of nodes>" }

GENERAL OPTIONS

Options with well-known behaviour:

•   audio.channels

•   audio.layout

•   audio.position

•   remote.name

EXAMPLE CONFIGURATION

# ~/.config/pipewire/pipewire.conf.d/my-parametric-equalizer.conf
context.modules = [
{   name = libpipewire-module-parametric-equalizer
    args = {
        #remote.name = "pipewire-0"
        #equalizer.filepath = "/a/b/EQ.txt"
        #equalizer.description = "Parametric EQ Sink"
        #audio.channels = 2
        #audio.position = [FL, FR]
        #capture.props = {
        #  node.name = "Parametric EQ input"
        #}
        #playback.props = {
        #  node.name = "Parametric EQ output"
        #}
    }
}
]

Since
    1.0.6