如何在PipeWire中添加LADSPA插件实现立体声音频后期处理

前置准备 #

先确保你已经安装了目标LADSPA立体声插件，以及ladspa-sdk工具包用于查询插件信息：

• Debian/Ubuntu系安装命令：apt install ladspa-sdk
• Fedora系安装命令：dnf install ladspa-devel

步骤1：查询目标LADSPA插件的核心信息 #

运行以下命令获取插件的ID、支持的声道数、可调参数列表：
analyseplugin <插件库文件路径>
比如查询Calf立体声均衡器的信息：
analyseplugin /usr/lib/ladspa/calf.so

注意：确认返回结果中输入、输出端口数量均为2，对应立体声左右声道，再进行后续配置

步骤2：创建PipeWire自定义配置目录 #

执行命令创建用户级配置目录（已存在可跳过）：
mkdir -p ~/.config/pipewire/pipewire.conf.d/

步骤3：编写LADSPA滤波链配置 #

在上述目录中新建配置文件10-ladspa-stereo-filter.conf，参考以下示例填写内容：

context.modules = [
    {   name = libpipewire-module-filter-chain
        args = {
            node.description = "Stereo LADSPA Filter"
            media.name = "Stereo LADSPA Filter"
            filter.graph = {
                nodes = [
                    {
                        type = ladspa
                        name = "your_ladspa_plugin_name"
                        plugin = <插件库文件路径>
                        label = <插件查询到的label字段>
                        control = {
                            <参数1名> = <参数1值>
                            <参数2名> = <参数2值>
                        }
                    }
                ]
                inputs = [ "your_ladspa_plugin_name:Input L" "your_ladspa_plugin_name:Input R" ]
                outputs = [ "your_ladspa_plugin_name:Output L" "your_ladspa_plugin_name:Output R" ]
            }
            audio.channels = 2
            audio.position = [ FL FR ]
            capture.props = {
                node.name = "effect_input.ladspa_stereo"
                media.class = Audio/Sink
            }
            playback.props = {
                node.name = "effect_output.ladspa_stereo"
                node.passive = true
            }
        }
    }
]

步骤4：加载配置生效 #

1. 先测试配置合法性：
   pipewire -c /usr/share/pipewire/pipewire.conf
   如果没有报错输出，按Ctrl+C终止测试
2. 重启PipeWire服务加载新配置：
   systemctl --user restart pipewire pipewire-pulse

步骤5：验证生效 #

执行命令查看LADSPA节点是否正常加载：
pw-cli list-objects | grep -i ladspa
也可以打开音频控制面板，选择名为Stereo LADSPA Filter的输出设备，播放音频测试效果。

注意事项 #

• 必须选择原生支持立体声的LADSPA插件，强制单声道插件处理双声道音频会出现声道合并、无声等异常
• 配置不生效时，可以直接删除~/.config/pipewire/pipewire.conf.d/10-ladspa-stereo-filter.conf后重启PipeWire即可恢复默认状态
• 不同插件的参数取值范围可以通过analyseplugin命令的返回结果查询，按需调整即可

内容的提问来源于stack exchange，提问作者nayana