@audio/spatial

July 10, 2026 · View on GitHub

Spatial & channel tools — stereo imaging, panning, headphone crossfeed.

PackageStatusWhat
@audio/spatial-pannerequal-power stereo panner
@audio/spatial-widenermid/side stereo widener
@audio/spatial-haasHaas precedence effect
@audio/spatial-autopanLFO-driven auto-panner
@audio/spatial-crossfeedheadphone crossfeed
@audio/spatial-binauralstructural binaural panner (Brown-Duda ITD + head-shadow ILD, no HRIR)
@audio/spatial-midsideplannedM/S encode-decode
@audio/spatial-channelsplitplannedchannel split/combine (FFmpeg channelsplit)
@audio/spatial-delayplannedper-channel delay (FFmpeg adelay)
@audio/spatial-surroundplannedstereo → 5.1 upmix

Extracted from effect (spatial/) and filter (eq/crossfeed). FFmpeg-parity targets: stereotools, stereowiden, extrastereo, bs2b.

spatial-binaural is azimuth-only (ITD + head-shadow ILD, per Brown & Duda 1998 eq. 2-5). Elevation is not implemented: the paper's pinna-echo model (eq. 8, Table I) has a per-listener-fitted scaling factor, not a general physical constant, and the paper itself flags it as unvalidated near 90° elevation — using someone's individual calibration as a fake default would misrepresent it as physics, so this atom omits it rather than invent generic coefficients.