Caution
Status: pre pre pre alpha DO NOT USE...
Taken from SoundID Reference Measure output file format name, swproj is a CLI
tool to parse, visualize, and "transpile" the SoundID measurement files to work
on Linux machines (e.g. export to
PipeWire Filter-Chain
configuration, or CamillaDSP, or other
open source DSP/RC software).
Room measurement:
$ swproj measure examples/measurement.swproj -o examples/measurement.png
measurement: measurement.swproj
points: 355
span: 20.0 hz .. 22000.0 hz (log-spaced)
left:
dynamic range: 13.51 db
min / max: -6.54 / +6.97 db
mean (>= 200 hz): -0.11 db
top peaks: 53.8 hz +6.97 db, 128.4 hz +6.54 db, 512.9 hz +3.47 db
top dips: 88.2 hz -2.88 db, 11228.2 hz -2.66 db, 13153.6 hz -2.43 db
right:
dynamic range: 13.95 db
min / max: -6.24 / +7.71 db
mean (>= 200 hz): -0.06 db
top peaks: 54.9 hz +7.71 db, 153.4 hz +6.85 db, 676.6 hz +3.04 db
top dips: 11228.2 hz -2.50 db, 95.4 hz -2.09 db, 261.8 hz -1.42 db
L-R asymmetry (30-300 hz): max 3.17 db, rms 1.68 db
wrote examples/measurement.png
Target EQ:
$ swproj target examples/target.json -o examples/target.png
target eq: target.json (name: 'Low volume')
[0] bell f= 250.0 hz gain=-1.00 db Q=1.00
[1] high-shelf f= 9000.0 hz gain=+1.50 db Q=1.00
[2] low-shelf f= 45.0 hz gain=+3.50 db Q=1.00
realised over 20-22k hz: max +3.76 db at 22.9 hz, min -1.06 db at 246.6 hz
wrote examples/target.png
# swproj camilladsp -m examples/measurement.swproj -t examples/target.json -f minimum -o examples/camilladsp.yaml
$ swproj camilladsp -h
Usage: swproj camilladsp [OPTIONS]
Emit CamillaDSP filters+pipeline YAML built from a SoundID measurement
and/or target EQ.
Options:
-m, --measure FILE Room measurement (.swproj).
-t, --target FILE Target EQ (.json).
-f, --filter [linear|minimum] Phase character of the room-correction FIR.
[default: (linear)]
-r, --rate INTEGER RANGE Sample rate (Hz). [default: 48000;
8000<=x<=384000]
-n, --taps INTEGER RANGE FIR length (samples). [default: 8192;
x>=256]
-b, --max-boost FLOAT RANGE Cap on inverse magnitude (dB). [default:
12.0; x>=0.0]
-o, --output FILE Write YAML to file (default: stdout).
-h, --help Show this message and exit.
# swproj pipewire -f minimum -m examples/measurement.swproj -t examples/target.json -o examples/pipewire.conf
$ swproj pipewire -h
Usage: swproj pipewire [OPTIONS]
Emit a PipeWire module-filter-chain config with inline FIR coefficients,
loadable via services.pipewire.configPackages or
/etc/pipewire/pipewire.conf.d/.
Options:
-m, --measure FILE Room measurement (.swproj).
-t, --target FILE Target EQ (.json).
-f, --filter [linear|minimum] Phase character of the room-correction FIR.
[default: (linear)]
-r, --rate INTEGER RANGE Sample rate (Hz). [default: 48000;
8000<=x<=384000]
-n, --taps INTEGER RANGE FIR length (samples). [default: 8192;
x>=256]
-b, --max-boost FLOAT RANGE Cap on inverse magnitude (dB). [default:
12.0; x>=0.0]
-o, --output FILE Write conf to file (default: stdout).
-h, --help Show this message and exit.See output example at examples/camilladsp.yaml and
examples/pipewire.conf.