EasyEffects 音频处理教程 / 02 - 安装与配置

02 - 安装与配置

在主流 Linux 发行版上安装 EasyEffects，配置 Flatpak 或原生包管理器，并完成初始设置。

2.1 前置条件检查

在安装 EasyEffects 之前，需要确认系统满足以下条件：

检查音频服务器

# 检查是否运行 PipeWire
pactl info | grep "Server Name"
# 期望输出: Server Name: PulseAudio (on PipeWire x.x.x)

# 或者直接检查 PipeWire 进程
systemctl --user status pipewire pipewire-pulse wireplumber

如果输出显示 PulseAudio 而非 PipeWire，说明系统仍在使用 PulseAudio，需要先迁移。

检查 PipeWire 版本

pw-cli info 0 | grep version
# 期望版本: >= 0.3.49

检查内核版本

uname -r
# 推荐: >= 5.15（低延迟内核更好）

前置条件检查清单

检查项	命令	期望结果
音频服务器	`pactl info \| grep "Server Name"`	包含 `PipeWire`
PipeWire 版本	`pw-cli info 0 \| grep version`	≥ 0.3.49
WirePlumber	`wpctl status`	正常输出设备列表
内核版本	`uname -r`	≥ 5.15
声卡检测	`aplay -l`	列出可用声卡
麦克风检测	`arecord -l`	列出可用录音设备

2.2 安装 PipeWire（如未安装）

如果你的系统尚未使用 PipeWire，以下是在主流发行版上迁移的方法。

Fedora（35+ 默认 PipeWire）

# Fedora 35+ 已默认使用 PipeWire，通常无需额外操作
# 确认安装
sudo dnf install pipewire pipewire-pulseaudio wireplumber

# 重启后检查
systemctl --user status pipewire pipewire-pulse wireplumber

Ubuntu / Debian

# Ubuntu 22.10+ / Debian 12+ 可通过包管理器安装
sudo apt install pipewire pipewire-pulse wireplumber

# 对于 Ubuntu 22.04 LTS，需要添加 PPA
sudo add-apt-repository ppa:pipewire-debian/pipewire-upstream
sudo apt update
sudo apt install pipewire pipewire-pulse wireplumber

Arch Linux

sudo pacman -S pipewire pipewire-pulse wireplumber pipewire-alsa

openSUSE

sudo zypper install pipewire pipewire-pulseaudio wireplumber

迁移后验证

# 重启 PipeWire 服务
systemctl --user restart pipewire pipewire-pulse wireplumber

# 验证
pactl info | grep "Server Name"
# 期望: Server Name: PulseAudio (on PipeWire x.x.x)

注意: 从 PulseAudio 迁移到 PipeWire 后，原有的 PulseAudio 配置文件（~/.config/pulse/）可能需要清理，以避免冲突。

2.3 安装 EasyEffects

方式一：Flatpak（推荐）

Flatpak 是安装 EasyEffects 的最佳方式，因为它自带所有依赖，不受发行版版本限制。

# 安装 Flatpak（如未安装）
# Fedora
sudo dnf install flatpak

# Ubuntu
sudo apt install flatpak

# Arch
sudo pacman -S flatpak

# 添加 Flathub 仓库
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# 安装 EasyEffects
flatpak install flathub com.github.wwmm.easyeffects

# 运行
flatpak run com.github.wwmm.easyeffects

Flatpak 权限配置:

# 确保 Flatpak 版 EasyEffects 可以访问 PipeWire
# 通常 Flatpak 会自动处理，但如遇问题可手动授权
flatpak override --user com.github.wwmm.easyeffects --filesystem=xdg-run/pipewire-0

方式二：原生包管理器

Fedora

sudo dnf install easyeffects

Ubuntu（22.10+）

sudo apt install easyeffects

Arch Linux

sudo pacman -S easyeffects

openSUSE

sudo zypper install easyeffects

方式三：源码编译

适用于需要最新开发版或自定义编译选项的用户。

# 安装构建依赖（以 Fedora 为例）
sudo dnf install meson gcc-c++ gtk4-devel libadwaita-devel \
  pipewire-devel gstreamer1-devel gstreamer1-plugins-base-devel \
  libsamplerate-devel libsndfile-devel libbs2b-devel \
  rubberband-devel speexdsp-devel rnnoise-devel \
  fftw-devel lilv-devel lv2-devel ladspa-devel \
  libebur128-devel nlohmann-json-devel

# 克隆源码
git clone https://github.com/wwmm/easyeffects.git
cd easyeffects

# 构建
meson setup build
ninja -C build

# 安装
sudo ninja -C build install

安装方式对比

对比维度	Flatpak	原生包	源码编译
依赖管理	自带所有依赖	需手动安装	需手动安装
版本更新	及时	跟随发行版	最新开发版
磁盘占用	较大（~200MB）	较小（~30MB）	较小
插件支持	内置	需额外安装	按需编译
推荐程度	⭐⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐

2.4 额外插件安装

EasyEffects 依赖 GStreamer 的插件生态系统。为获得最丰富的效果器，建议安装以下额外插件：

LADSPA / LV2 插件

# Fedora
sudo dnf install \
  swh-plugins \
  rubberband-ladspa \
  lsp-plugins \
  calf-studio-gear-plugins \
  zam-plugins \
  x42-plugins

# Ubuntu
sudo apt install \
  swh-plugins \
  rubberband-ladspa \
  lsp-plugins-ladspa \
  calf-plugins \
  zam-plugins

# Arch
sudo pacman -S \
  swh-plugins \
  rubberband \
  lsp-plugins \
  calf \
  zam-plugins

常用插件包说明

插件包	提供的效果器	用途
`swh-plugins`	多段均衡器、混响、延迟	基础效果器
`lsp-plugins`	参数均衡器、压缩器、限制器	专业级效果器
`calf-studio-gear-plugins`	均衡器、压缩器、混响、合唱	综合效果器套件
`rubberband`	时间拉伸/音高变换	音高/速度调整
`zam-plugins`	压缩器、限制器、均衡器	模拟风格效果器
`x42-plugins`	分析仪、均衡器	分析与测量

Flatpak 版插件安装

# Flatpak 版 EasyEffects 自带大部分插件
# 如需额外插件，安装 Flatpak 版 GStreamer 插件
flatpak install flathub org.freedesktop.Platform.GStreamer.gstreamer-extra
flatpak install flathub org.freedesktop.Platform.Plugin.ffmpeg

2.5 初始配置

首次启动

# 命令行启动
easyeffects

# 或 Flatpak 版
flatpak run com.github.wwmm.easyeffects

# 或通过应用菜单找到 "EasyEffects" 图标

首次启动后，EasyEffects 会在 PipeWire 中注册为处理节点。

验证 PipeWire 连接

# 检查 EasyEffects 是否已注册为 PipeWire 节点
pw-dump | grep -i easyeffects
# 应该能看到 easyeffects_sink 和 easyeffects_source 相关节点

设置开机自启

通过 EasyEffects 内置设置

EasyEffects 的偏好设置中有「后台服务模式」选项。启用后，EasyEffects 会在后台运行而不显示界面，适合开机自启。

打开 EasyEffects
点击右上角的 ☰ 菜单
选择 偏好设置（Preferences）
启用 后台服务模式（Service Enable）

通过桌面环境的自启动

# 创建桌面文件
mkdir -p ~/.config/autostart
cp /usr/share/applications/com.github.wwmm.easyeffects.desktop ~/.config/autostart/

# 或创建简化版
cat > ~/.config/autostart/easyeffects.desktop << 'EOF'
[Desktop Entry]
Type=Application
Name=EasyEffects
Exec=easyeffects --gapplication-service
Hidden=false
NoDisplay=true
X-GNOME-Autostart-enabled=true
EOF

配置 PipeWire 低延迟

为获得最佳的实时音频处理体验，建议调整 PipeWire 的延迟设置。

编辑 ~/.config/pipewire/pipewire.conf.d/low-latency.conf：

mkdir -p ~/.config/pipewire/pipewire.conf.d/

cat > ~/.config/pipewire/pipewire.conf.d/low-latency.conf << 'EOF'
context.properties = {
    default.clock.rate = 48000
    default.clock.quantum = 256
    default.clock.min-quantum = 32
    default.clock.max-quantum = 1024
}
EOF

参数说明：

参数	默认值	低延迟值	说明
`clock.rate`	48000	48000	采样率（Hz）
`clock.quantum`	1024	256	缓冲区大小（帧数）
`clock.min-quantum`	32	32	最小缓冲区
`clock.max-quantum`	2048	1024	最大缓冲区

延迟计算公式：延迟(ms) = quantum / rate × 1000

quantum=1024, rate=48000 → 约 21ms
quantum=256, rate=48000 → 约 5.3ms
quantum=128, rate=48000 → 约 2.7ms

# 重启 PipeWire 使配置生效
systemctl --user restart pipewire pipewire-pulse wireplumber

注意: quantum 值过小可能导致音频卡顿（xrun）。如果出现爆音或断断续续，请适当增大 quantum 值。

2.6 验证安装

功能验证步骤

# 1. 启动 EasyEffects
easyeffects &

# 2. 播放测试音频
# 使用系统音频播放器播放音乐，确认声音正常
paplay /usr/share/sounds/freedesktop/stereo/audio-test-signal.oga

# 3. 测试麦克风输入
# 在 EasyEffects 中切换到输入标签页
arecord -d 5 -f cd /tmp/test.wav && aplay /tmp/test.wav

# 4. 检查效果器是否工作
# 在 EasyEffects 输出页面启用均衡器，调整频段，确认声音变化

# 5. 检查 PipeWire 节点
pw-top
# 应该能看到 easyeffects_sink 和相关节点

常见安装问题排查

问题	可能原因	解决方案
EasyEffects 无法启动	缺少 PipeWire	安装 PipeWire 并重启
启动后无声音	效果链配置错误	重置预设或禁用所有效果
界面语言不对	系统 locale 设置	检查 `LANG` 环境变量
Flatpak 版无声音	权限不足	执行权限覆盖命令
插件加载失败	缺少插件包	安装对应的插件包
效果器无效	PipeWire 路由问题	检查 `pw-top` 节点连接

2.7 卸载 EasyEffects

Flatpak 版卸载

# 卸载
flatpak uninstall com.github.wwmm.easyeffects

# 清理残留数据
rm -rf ~/.var/app/com.github.wwmm.easyeffects/

原生包卸载

# Fedora
sudo dnf remove easyeffects

# Ubuntu
sudo apt remove easyeffects

# Arch
sudo pacman -Rns easyeffects

清理配置

# 删除用户配置和预设
rm -rf ~/.config/easyeffects/

2.8 要点回顾

EasyEffects 推荐通过 Flatpak 安装，兼容性最好
PipeWire 是必须的前置条件
安装额外的 LADSPA/LV2 插件可获得更丰富的效果器
建议调整 PipeWire 的 quantum 参数以优化延迟
开启后台服务模式实现开机自启

2.9 注意事项

PulseAudio 用户: 如果系统仍在使用 PulseAudio，必须先迁移到 PipeWire 才能使用 EasyEffects。迁移前请备份重要配置。

Flatpak 磁盘占用: Flatpak 版本因自带运行时和依赖，首次安装可能需要下载约 500MB 的数据。请确保磁盘空间充足。

低延迟风险: 将 PipeWire quantum 设置过低（如 64）可能导致 CPU 占用过高和音频卡顿。建议从 256 开始逐步降低测试。

蓝牙设备: 蓝牙音频设备可能需要额外的编解码器支持。如遇问题，安装 pipewire-codec-aptx 等包。

EasyEffects 音频处理教程 / 02 - 安装与配置

02 - 安装与配置

2.1 前置条件检查

检查音频服务器

检查 PipeWire 版本

检查内核版本

前置条件检查清单

2.2 安装 PipeWire（如未安装）

Fedora（35+ 默认 PipeWire）

Ubuntu / Debian

Arch Linux

openSUSE

迁移后验证

2.3 安装 EasyEffects

方式一：Flatpak（推荐）

方式二：原生包管理器

Fedora

Ubuntu（22.10+）

Arch Linux

openSUSE

方式三：源码编译

安装方式对比

2.4 额外插件安装

LADSPA / LV2 插件

常用插件包说明

Flatpak 版插件安装

2.5 初始配置

首次启动

验证 PipeWire 连接

设置开机自启

通过 EasyEffects 内置设置

通过桌面环境的自启动

配置 PipeWire 低延迟

2.6 验证安装

功能验证步骤

常见安装问题排查

2.7 卸载 EasyEffects

Flatpak 版卸载

原生包卸载

清理配置

2.8 要点回顾

2.9 注意事项

2.10 扩展阅读