https://github.com/stepbrobd/swproj
toolkit for sonarworks soundid
https://github.com/stepbrobd/swproj
Last synced: 19 days ago
JSON representation
toolkit for sonarworks soundid
- Host: GitHub
- URL: https://github.com/stepbrobd/swproj
- Owner: stepbrobd
- License: mit
- Created: 2026-05-17T21:29:20.000Z (about 2 months ago)
- Default Branch: master
- Last Pushed: 2026-06-06T07:07:24.000Z (28 days ago)
- Last Synced: 2026-06-06T09:07:29.377Z (28 days ago)
- Language: Python
- Homepage:
- Size: 2.06 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: license.txt
Awesome Lists containing this project
README
# SWProj
Binary Cache:
- Cache:
- Key: `cache.ysun.co-1:WxPYwT5g3kt9XhUhHPpNLZKI9HIOsVVAuqSHpok8Qt4=`
> [!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](https://docs.pipewire.org/page_module_filter_chain.html)
configuration, or [CamillaDSP](https://github.com/HEnquist/camilladsp), or other
open source DSP/RC software).
Room measurement:
```console
$ 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
```
```console
# 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`](examples/camilladsp.yaml) and
[`examples/pipewire.conf`](examples/pipewire.conf).