spa-resample
PipeWire resampler debugging utility
TLDR
SYNOPSIS
spa-resample [OPTIONS] INFILE OUTFILE
DESCRIPTION
spa-resample is a command-line utility that uses the PipeWire SPA resampler to convert audio files from one sample rate and format to another. It reads a WAV input file, applies resampling with the specified parameters, and writes the result to a WAV output file.The tool is primarily intended for testing and debugging the PipeWire resampler implementation rather than as a general-purpose audio conversion tool. It provides direct access to the same resampling algorithm that PipeWire uses internally for audio stream processing, making it useful for verifying resampler behavior and quality.
PARAMETERS
-r RATE, --rate=RATE
Output sample rate.-f FORMAT, --format=FORMAT
Output sample format (s8 | s16 | s32 | f32 | f64).-q QUALITY, --quality=QUALITY
Resampler output quality (0-14). Higher values produce better quality at the cost of more CPU usage.-c FLAGS, --cpuflags=FLAGS
CPU feature flags for SIMD optimization selection. See spa/support/cpu.h for details.-v
Verbose operation.-h
Show help.
CAVEATS
This tool is designed for testing and debugging purposes only, not for production audio conversion workflows. For general-purpose audio format conversion, dedicated tools like sox or ffmpeg are more appropriate. Only WAV files are supported as input and output formats. The quality parameter range of 0-14 is specific to the PipeWire SPA resampler and does not correspond to quality scales used by other resamplers.
HISTORY
spa-resample is part of the PipeWire multimedia framework, which was created by Wim Taymans and first released in 2017. PipeWire was designed as a unified audio and video server to replace both PulseAudio and JACK on Linux systems. The spa-resample utility provides standalone access to PipeWire's built-in SPA (Simple Plugin API) resampler, which supports multiple SIMD-optimized backends for efficient sample rate conversion.
