oracular (7) libpipewire-module-parametric-equalizer.7.gz

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'

GENERAL OPTIONS

       Options with well-known behaviour:

       • audio.channels

       • audio.position

       • remote.name

EXAMPLE CONFIGURATION

       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]
           }
       }
       ]

       Since
           1.0.6