pipewire_audio

Tags: desktop, audio, pipewire
Secrets needed: No
Runs on: Desktop group only (unless skip_pipewire_audio: true)

Replaces Easy Effects with native PipeWire filter-chain modules using LSP LV2 and LADSPA plugins — no Flatpak, no GUI, no D-Bus service.

What It Does

  1. Deploys speaker-dsp.conf — a PipeWire filter-chain that creates a virtual "Speakers (DSP)" sink
  2. Deploys mic-dsp.conf — a PipeWire filter-chain that creates a virtual "Microphone (DSP)" source
  3. Configures WirePlumber to prefer the DSP nodes as default devices
  4. Cleans up any previous Easy Effects installation (Flatpak, autostart, presets)

Internal task boundaries

The role keeps one public pipewire tag and the skip_pipewire_audio gate, but the entrypoint delegates to focused task files in this order:

  1. tasks/platform.yml detects the host platform, installs mutable-system prerequisites, and publishes plugin availability facts.
  2. tasks/dsp.yml deploys the speaker and microphone filter-chain configs.
  3. tasks/systemd.yml configures the LADSPA path and persistent microphone routing service.
  4. tasks/cleanup.yml removes obsolete WirePlumber and Easy Effects state.

The split is organizational only: conditions, handlers, paths, and the role's execution order remain unchanged.

Output Chain: Speaker DSP

Signal path: 16-band Parametric EQ → Bass Enhancer → Exciter → Limiter (all LSP LV2).

StageLV2 PluginWhat It Does
eqLSP ParaEQ x16 LRCorrective loudness curve with subsonic HPF @ 120 Hz
bassLSP Bass EnhancerHarmonic bass synthesis for small speakers
exciterLSP ExciterCrystalizer substitute — adds presence and air
limLSP LimiterBrickwall peak limiter @ -0.5 dBFS

The EQ curve is a direct translation of the Easy Effects 15-band preset — ~2.5 dB cut through low-mids (220-600 Hz), ~3.5 dB peak at 3.2 kHz, tapering to ~1.5 dB boost above 8 kHz.

Simplification: To run just EQ + Limiter (the most critical, crash-proof chain), comment out the bass and exciter nodes in speaker-dsp.conf and remove their links.

Input Chain: Microphone DSP

Signal path: RNNoise → Compressor (LADSPA + LSP LV2).

StagePluginWhat It Does
rnnoiselibrnnoise_ladspa.soReal-time neural network noise suppression (VAD-enabled)
compLSP Compressor StereoDownward compression, -24 dB threshold, 2:1 ratio

Bootc Image Requirements

These packages must be in the bootc image (Containerfile):

lsp-plugins-lv2
noise-suppression-for-voice

The filter-chain configs reference:

  • LSP LV2 bundles under /usr/lib64/lv2/ (Fedora default LV2 path)
  • RNNoise LADSPA at /usr/lib64/ladspa/librnnoise_ladspa.so

Verifying

On a target machine after deploy:

# Check DSP nodes appeared
pw-cli ls Node | grep -E 'speaker_dsp|mic_dsp'

# Check defaults
wpctl status | head -20

# Watch for plugin loading errors
journalctl --user -u pipewire -f | grep -iE 'error|filter-chain|lv2'

# Verify LSP plugins are discoverable
lv2ls | grep lsp-plug
lv2info http://lsp-plug.in/plugins/lv2/para_equalizer_x16_lr | head -5

# Verify LADSPA plugin
ls /usr/lib64/ladspa/librnnoise_ladspa.so

Troubleshooting

SymptomLikely CauseFix
DSP node doesn't appearLSP/LADSPA plugins missing from bootc imageVerify with lv2ls, ls /usr/lib64/ladspa/
Port name mismatchLSP plugin version changed port symbolsRun lv2info <uri> | grep 'port.*symbol' and update config
Audio routing loopPipeWire/WirePlumber bugDon't set the DSP sink as default manually; let WirePlumber handle it
No bass enhancer/exciter effectPlugin UID mismatchComment them out in config for a leaner chain

Notes

  • PipeWire must be restarted after deploying configs (handled by Ansible handlers)
  • Select "Speakers (DSP)" and "Microphone (DSP)" in GNOME Sound settings if WirePlumber doesn't auto-select them
  • The virtual sink approach works because PipeWire prevents self-looping when capture/playback share the same node.name
  • To skip: set skip_pipewire_audio: true in host_vars, or exclude the pipewire tag