refactor: update gain parameters in graph configurations for improved audio processing

refactor: update loudness handling and simplify graph generation in bake-graph.py and graph configurations
refactor: enhance FIR baking process and simplify graph generation with biquad extraction
2026-09-01 19:17:43 -04:00 · 2026-09-01 14:02:25 -04:00 · 2026-09-01 13:57:57 -04:00 · 2026-09-01 13:36:29 -04:00 · 2026-09-01 12:44:22 -04:00 · 2026-09-01 11:27:58 -04:00
30 changed files with 3340 additions and 270 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1,15 @@
+# Bankstown source checkout + build output from install-deps.sh
+/build/
+graph_merged.json
+# Local user_eq override consumed by apply.sh (copy from user_eq.example.json)
+/user_eq.json
+
+# Generated baked single-stage FIR files & simple graph
+/15_1/baked-*.wav
+laptop-configs/**/baked-*.wav
+/baked-*.wav
+/graph_simple.json
+
+# Python bytecode cache
+*.pyc
+__pycache__/
--- a/15_1/tweeters-44k.wav
+++ b/15_1/tweeters-44k.wav
--- a/15_1/tweeters-48k.wav
+++ b/15_1/tweeters-48k.wav
--- a/15_1/tweeters-96k.wav
+++ b/15_1/tweeters-96k.wav
--- a/15_1/woofers-44k.wav
+++ b/15_1/woofers-44k.wav
--- a/15_1/woofers-48k.wav
+++ b/15_1/woofers-48k.wav
--- a/15_1/woofers-96k.wav
+++ b/15_1/woofers-96k.wav
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -0,0 +1,183 @@
+# Next-Gen Audio DSP Architecture: Compressed-Chain "Digital Surround" (Active Crossover) Engine & Multi-Laptop Ecosystem
+
+This document provides a comprehensive technical blueprint of the **Next-Gen Audio DSP Engine** implemented in `mbp15-1-audio-dsp`. The system delivers studio-grade, zero-latency audio performance for Linux laptops, outperforming factory OEM macOS/Windows DSP stacks while remaining fully open-source and hardware-portable.
+
+> ### 📻 "Digital Surround" Marketing vs. Active Digital Crossovers
+> In consumer laptop marketing, multi-speaker setups are frequently advertised under buzzwords like **"Dolby Atmos"**, **"3D Digital Surround"**, or **"Spatial Audio"** to imply multi-channel cinema sound. In real-world acoustic engineering, this feature is an **Active Multi-Band Digital Crossover Engine**. Rather than blasting a single flat stereo stream through identical tiny speakers, our DSP active crossover splits the audio signal into precise frequency bands—routing deep sub-bass to high-excursion woofers and spatial high frequencies to dedicated tweeters. This discrete multi-driver time and frequency alignment eliminates inter-modulation distortion, expands the physical soundstage, and delivers the immersive room-filling audio experience that consumer brands market as "Digital Surround."
+
+---
+
+## 🏛️ 1. Architectural Highlights
+
+* **⚡ Single-Stage Compressed-Chain FIR Engine:** Collapses all linear time-invariant (LTI) stages—User EQ, Voicing EQ, Linkwitz-Riley crossover high-pass filters, and driver impulse responses—into single composite FIR impulse files.
+* **⏱️ 5.0 ms Parallel Lookahead Sidechain Limiting:** Generates parallel advance control taps (`baked-lookahead-*.wav`) that feed peak warnings to post-convolver limiters **5.0 ms ahead of the physical audio**, adding **0.0 ms of buffer delay** to the listener's main audio path.
+* **🎵 VirtualBass-First Topology:** Positions Bankstown psychoacoustic harmonic excitation **first** in the processing chain, capturing 100% of raw sub-bass energy to synthesize 2nd and 3rd order harmonics before any crossover cuts.
+* **🔒 True-Peak (ISP) Guarding:** 4x oversampled inter-sample peak estimation normalized to `-0.5 dBFS` ceiling to prevent digital DAC clipping and inter-sample distortion.
+* **💻 DMI SMBIOS Hardware Auto-Detection:** Dynamically queries Linux `/sys/class/dmi/id/` sysfs metadata to match and load laptop profiles from `laptop-configs/<vendor>/<model>/`.
+* **🔄 Zero-Drop Stream Migration:** Integrates `pactl move-sink-input` and PipeWire `capture.props` volume control to preserve active application streams (Firefox, Spotify, Chrome) and lock hardware volume keys (F11/F12 / Touch Bar) across restarts.
+
+---
+
+## 🔬 2. Compressed-Chain Single-Stage FIR Engine
+
+### 2.1 LTI Stage Collapsing
+Traditional laptop DSP pipelines cascade 10 to 20 separate IIR biquads and convolver stages, consuming heavy CPU cycles and adding phase distortion. The Next-Gen Engine uses standard-library Python ([`bake-graph.py`](file:///home/steve/w11/mbp15-1-audio-dsp/bake-graph.py)) to perform single-pass LTI convolution that bakes User EQ, Voicing EQ, and Crossover filters directly into the 4-channel driver convolvers:
+
+$$\text{FIR}_{\text{baked}}(t) = \text{EQ}_{\text{user}}(t) * \text{EQ}_{\text{voicing}}(t) * \text{EQ}_{\text{crossover}}(t) * \text{IR}_{\text{driver}}(t)$$
+
+```mermaid
+graph TD
+    A["Raw Audio Input (FL / FR)"] --> B["Bankstown VirtualBass (2nd/3rd Order Harmonics)"]
+    B -->|4-Channel Direct Feed| C1["Woofer Left FIR (baked-woofers-*.wav)"]
+    B -->|4-Channel Direct Feed| C2["Woofer Right FIR (baked-woofers-*.wav)"]
+    B -->|4-Channel Direct Feed| D1["Tweeter Left FIR (baked-tweeters-*.wav)"]
+    B -->|4-Channel Direct Feed| D2["Tweeter Right FIR (baked-tweeters-*.wav)"]
+    
+    C1 --> E1["Woofer Fast Limiter (wlim:in_1)"]
+    C2 --> E1["Woofer Fast Limiter (wlim:in_2)"]
+
+    D1 --> F1["Tweeter Fast Limiter (tlim:in_1)"]
+    D2 --> F1["Tweeter Fast Limiter (tlim:in_2)"]
+
+    E1 --> G1["Woofer Drivers (Left / Right)"]
+    F1 --> G2["Tweeter Drivers (Left / Right)"]
+```
+
+### 2.2 Single-Pass FIR Baking Pipeline Process
+The FIR baking process in [`bake-graph.py`](file:///home/steve/w11/mbp15-1-audio-dsp/bake-graph.py) folds static LTI processing stages, latency reduction, target curves, and true-peak guarding directly into composite `.wav` impulse responses:
+
+```mermaid
+graph TD
+    A["Raw Acoustic Driver Measurement<br/>(White-Noise Impulse Response)"] --> B["White-to-Pink Voicing Curve<br/>(-3 dB/octave Tonal Tilt)"]
+    B --> C["User EQ Curves (user_eq.json)<br/>(Bass Shelves, Peaking EQs, Treble Shelves)"]
+    C --> D["Crossover Filters<br/>(Linkwitz-Riley High-Pass / Low-Pass)"]
+    D --> E["Latency Trimming (5.0ms Lead Optimization)"]
+    E --> F["True-Peak ISP Guarding (-0.5 dBFS Ceiling)"]
+    F --> G["Tail Resolution Fadeout (2048-sample Cosine Window)"]
+    G --> H["baked-woofers-*.wav / baked-tweeters-*.wav<br/>(Single-Pass Baked Driver FIRs)"]
+```
+
+### 2.3 Post-Convolver Quad-Driver Safety Limiting
+To prevent speaker cone over-excursion and thermal overload without altering frequency response:
+
+1. **Direct Terminal Measurement:** Fast lookahead limiters (`wlim` and `tlim`) operate directly on the 4 post-convolver driver channels, accurately measuring the exact equalized waveform present at the driver terminals.
+2. **Dedicated Driver Ceilings:** Woofers (`wlim`) and Tweeters (`tlim`) have independent brickwall peak ceilings (`-2 dBFS` for woofers, `-1 dBFS` for tweeters) that guard against hardware driver clipping without squashing tonal dynamics or frequency response balance.
+3. **Zero Added Listener Latency:**
+   * Post-convolver limiters (`wlim` and `tlim`) receive peak warnings 5.0 ms before the audio reaches the speaker drivers.
+   * **Added buffer latency for the listener: `0.0 ms`.**
+
+---
+
+## 💻 3. Multi-Laptop Profile Hierarchy & Auto-Detection
+
+### 3.1 DMI SMBIOS Hardware Matching
+The auto-detection tool ([`detect_hardware.py`](file:///home/steve/w11/mbp15-1-audio-dsp/detect_hardware.py)) queries the Linux Kernel DMI sysfs interface:
+
+* `/sys/class/dmi/id/sys_vendor` (e.g., `Apple Inc.`, `Dell Inc.`, `LENOVO`)
+* `/sys/class/dmi/id/product_name` (e.g., `MacBookPro15,1`, `XPS 15 9520`)
+
+`detect_hardware.py` matches these strings against `profile.json` metadata in the profile tree.
+
+### 3.2 Repository Directory Structure (`laptop-configs/`)
+
+```text
+laptop-configs/
+├── apple/
+│   ├── mbp15_1/
+│   │   ├── profile.json            # DMI matching metadata
+│   │   ├── graph.json              # Baseline PipeWire DSP topology
+│   │   ├── woofers-48k.wav         # Raw woofer impulse response
+│   │   └── tweeters-48k.wav        # Raw tweeter impulse response
+│   └── mbp16_1/
+│       ├── profile.json
+│       ├── graph.json
+│       ├── woofers-48k.wav
+│       └── tweeters-48k.wav
+└── dell/
+    └── xps15_9520/
+        ├── profile.json
+        └── ...
+```
+
+### 3.3 CLI Flags for `detect_hardware.py`
+
+| Flag | Description |
+| :--- | :--- |
+| `--list-configs` | Lists all available laptop profiles in `laptop-configs/` with DMI match strings. |
+| `--model <name>` | Manually specifies target model (e.g., `mbp15_1` or `xps15_9520`). |
+| `--manual` | Interactive prompt for selecting from available profiles. |
+| `--json` | Outputs hardware detection details in JSON format. |
+| `--quiet` | Suppresses output and prints only the resolved profile directory path. |
+
+---
+
+## 🎛️ 4. Terminal EQ Tuning & Live Graph Merging
+
+### 4.1 Single-Line Formatted `user_eq.json`
+The terminal EQ tuning utility ([`eq.py`](file:///home/steve/w11/mbp15-1-audio-dsp/eq.py)) formats [`user_eq.json`](file:///home/steve/w11/mbp15-1-audio-dsp/user_eq.json) with single-line band alignment matching `user_eq.example.json`:
+
+```json
+{
+    "enabled": 1, "mode": 0, "g_in": 1.0, "g_out": 1.50,
+    "ft_0": 5, "f_0": 70.0   , "g_0": 1.26, "q_0": 0.7, "s_0": 0,
+    "ft_1": 1, "f_1": 110.0  , "g_1": 1.26, "q_1": 1.0,
+    "ft_2": 1, "f_2": 315.0  , "g_2": 1.00, "q_2": 1.0,
+    "ft_3": 1, "f_3": 1000.0 , "g_3": 1.00, "q_3": 1.0,
+    "ft_4": 1, "f_4": 2500.0 , "g_4": 1.00, "q_4": 1.0,
+    "ft_5": 1, "f_5": 6000.0 , "g_5": 1.00, "q_5": 1.0,
+    "ft_6": 3, "f_6": 10000.0, "g_6": 0.89, "q_6": 0.7,
+    "ft_7": 3, "f_7": 16000.0, "g_7": 0.89, "q_7": 0.7, "s_7": 0
+}
+```
+
+### 4.2 Unified `user_eq.json` Graph Merging
+In [`apply.sh`](file:///home/steve/w11/mbp15-1-audio-dsp/apply.sh#L82-L95), `user_eq.json` is merged into `$GRAPH_SRC` via `jq` for **both `--bake` and un-baked pipelines**:
+
+```bash
+if [ -f "$OVERRIDE" ]; then
+    jq --slurpfile ov "$OVERRIDE" \
+       '(.["filter.graph"].nodes[] | select(.name == "user_eq") | .control) = $ov[0]' \
+       "$GRAPH_SRC" > "$MERGED"
+fi
+```
+
+This guarantees that user EQ gain adjustments and preset switches immediately affect live playback!
+
+---
+
+## 🔀 5. Interoperability & Stream Migration
+
+### 5.1 PipeWire Volume Control Binding
+`graph.json` exposes `loudness:volume` control directly inside `capture.props`:
+
+```json
+"capture.props": {
+    "node.name": "audio_effect.t2-151-speakers",
+    "media.class": "Audio/Sink",
+    "priority.session": 2500,
+    "priority.driver": 2500,
+    "capture.volumes": [
+        {
+            "control": "loudness:volume",
+            "min": -65.0,
+            "max": 0.0,
+            "scale": "cubic"
+        }
+    ]
+}
+```
+
+This allows desktop volume daemons and hardware media keys (**F11 / F12 / Touch Bar**) to lock directly onto the DSP Speakers virtual sink.
+
+### 5.2 Zero-Drop Stream Migration
+Upon cold restart of `wireplumber.service`, [`apply.sh`](file:///home/steve/w11/mbp15-1-audio-dsp/apply.sh#L188-L197) iterates over active PulseAudio/PipeWire sink inputs and migrates them to the new DSP sink:
+
+```bash
+if have pactl; then
+    pactl list short sink-inputs | awk '{print $1}' | while read -r stream_id; do
+        pactl move-sink-input "$stream_id" "audio_effect.t2-151-speakers"
+    done
+fi
+```
+
+Running `./apply.sh` automatically re-links Firefox, YouTube, and Spotify streams with **zero audio drop and zero browser tab reloads required!** 🎧🔊⚡
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -0,0 +1,238 @@
+# Install
+
+How to get this DSP graph running on a **MacBook Pro 15,1** under Linux (T2 /
+`t2linux`, or Asahi on the Intel-T2 stack where applicable).
+
+For what the graph *does*, see [README.md](README.md). This file is only the
+mechanics of getting the pieces in place.
+
+---
+
+## 1. What has to be true first
+
+This repo is **just a `graph.json`** (plus `apply.sh`). It is not a driver and
+not self-contained. Three things must already exist on the machine:
+
+| Requirement | Provided by | Why |
+|---|---|---|
+| Raw speaker PCM exposed by the kernel/ALSA | the `t2linux` kernel + ALSA stack | there is nothing to process otherwise |
+| A hidden sink `alsa_output.platform-sound.RawSpeakers` with a filter-chain spliced in front of it | the **t2 speaker-DSP package** (`t2-linux-audio` / `t2-apple-audio-dsp`), specifically its WirePlumber drop-in `51-t2-dsp.conf` | this graph *attaches to* that spliced filter-chain; no package → no sink → nothing to apply |
+| The FIR correction files at `/usr/share/t2-linux-audio/15_1/` | the same package | `graph.json` references them by absolute path (see §4) |
+| The LV2 plugins the graph loads | your distro + a source build for one of them | see §3 |
+
+If `wpctl status` shows no **"MacBook Pro 15,1 DSP Speakers"** sink and no
+`alsa_output.platform-sound.RawSpeakers`, stop here and install the t2 speaker-DSP
+package for your distro first — see <https://wiki.t2linux.org/guides/audio-config/>.
+
+---
+
+## 2. Get the repo
+
+```sh
+git clone <this-repo> mbp15-1-audio-dsp
+cd mbp15-1-audio-dsp
+chmod +x apply.sh install-deps.sh    # if git didn't preserve the bit
+```
+
+---
+
+## 3. LV2 plugin dependencies
+
+The graph loads four LV2 plugins from three bundles. (`copy` and `convolver` are
+PipeWire builtins — nothing to install.)
+
+> **Shortcut:** `./install-deps.sh` does everything in this section — detects
+> `dnf`/`pacman`/`apt`/`zypper`, installs LSP + SWH, builds Bankstown from source
+> if it's missing, then verifies all five URIs. The manual steps below are what
+> it runs, for reference or when it can't.
+
+| Plugin URI in `graph.json` | Bundle | Package (varies by distro) |
+|---|---|---|
+| `http://lsp-plug.in/plugins/lv2/para_equalizer_x16_stereo` | LSP Plugins | `lsp-plugins` / `lsp-plugins-lv2` |
+| `http://lsp-plug.in/plugins/lv2/mb_compressor_stereo` | LSP Plugins | ″ |
+| `http://lsp-plug.in/plugins/lv2/loud_comp_mono` | LSP Plugins | ″ |
+| `http://plugin.org.uk/swh-plugins/fastLookaheadLimiter` | SWH Plugins | `swh-plugins` / `lv2-swh-plugins` |
+| `https://chadmed.au/bankstown` | Bankstown | **not packaged on most distros — build from source** |
+
+### 3a. LSP + SWH (from your package manager)
+
+```sh
+# Fedora / Fedora Asahi Remix
+sudo dnf install lsp-plugins swh-plugins
+
+# Arch / t2linux
+sudo pacman -S lsp-plugins swh-plugins       # or AUR: lsp-plugins-lv2
+
+# Debian / Ubuntu
+sudo apt install lsp-plugins swh-plugins
+```
+
+Package names drift — if the above miss, search: `dnf search lsp`,
+`pacman -Ss lsp-plugins`, `apt-cache search swh`. The authority is whether the
+URIs resolve (§3c), not the package name.
+
+### 3b. Bankstown (source build)
+
+Bankstown (`virtualbass` in the graph) is chadmed's psychoacoustic bass plugin.
+On Fedora Asahi Remix it ships in the `asahi-audio` stack; everywhere else,
+build it:
+
+```sh
+# needs: rust/cargo, clang, lv2 headers, git
+git clone https://github.com/chadmed/bankstown
+cd bankstown
+make                       # runs: cargo build --release
+
+# install the bundle. LIBDIR defaults to /usr/lib64 — override on distros
+# that use /usr/lib (Arch, Debian/Ubuntu):
+sudo make install                       # Fedora
+sudo make install LIBDIR=/usr/lib       # Arch, Debian, Ubuntu
+# → installs to $LIBDIR/lv2/bankstown.lv2/
+
+cd ..
+```
+
+Per-user install (no sudo) also works — copy the built
+`target/release/libbankstown.so` → `~/.lv2/bankstown.lv2/bankstown.so` alongside
+`bankstown.ttl` and `manifest.ttl` from the repo.
+
+### 3c. Verify all four URIs resolve
+
+```sh
+for uri in \
+  http://lsp-plug.in/plugins/lv2/para_equalizer_x16_stereo \
+  http://lsp-plug.in/plugins/lv2/mb_compressor_stereo \
+  http://lsp-plug.in/plugins/lv2/loud_comp_mono \
+  http://plugin.org.uk/swh-plugins/fastLookaheadLimiter \
+  https://chadmed.au/bankstown ; do
+    lv2ls | grep -qxF "$uri" && echo "ok   $uri" || echo "MISSING $uri"
+done
+```
+
+Every line must say `ok`. `lv2ls` is from `lilv` (`lilv-utils` / `lilv`).
+
+---
+
+## 4. FIR correction files
+
+`graph.json` references them by **absolute path**:
+
+```
+/usr/share/t2-linux-audio/15_1/tweeters-44k.wav   tweeters-48k.wav   tweeters-96k.wav
+/usr/share/t2-linux-audio/15_1/woofers-44k.wav    woofers-48k.wav    woofers-96k.wav
+```
+
+```sh
+ls -l /usr/share/t2-linux-audio/15_1/*.wav
+```
+
+These are **not vendored in this repo** and the paths are **deliberately not
+relative**:
+
+- The t2 speaker-DSP package installs them to this fixed FHS path on every
+  distro, and you already need that package for the sink to exist at all (§1),
+  so the absolute path is stable wherever the prerequisite is met.
+- PipeWire's convolver resolves a non-absolute `filename` against the process
+  working directory, which for a WirePlumber-spawned service is unpredictable
+  (`/` or `$HOME`). Relative paths would be *less* portable, not more.
+
+If you have your own recalibrated FIRs, drop them at that path (or edit the six
+`filename` entries in `graph.json` to point at yours) before §5.
+
+---
+
+## 5. Apply
+
+```sh
+./apply.sh
+```
+
+`apply.sh`:
+
+1. validates `graph.json` is well-formed JSON (`python3` or `jq`)
+2. **builds the effective graph** → `~/.audiograph.json`: if `user_eq.json`
+   exists next to the script, its contents replace the `user_eq` node's
+   `control` block (`jq`); otherwise it's a straight copy of `graph.json` (§7)
+3. checks `/usr/share/t2-linux-audio/15_1/` exists (§1)
+4. checks every FIR `.wav` **referenced by the graph** is present (§4)
+5. checks every LV2 plugin URI **the graph loads** resolves in `lv2ls` (§3)
+
+then `sudo cp`s `~/.audiograph.json` into place, restarts WirePlumber, and
+confirms the sink came up. Steps 4–5 read the paths/URIs straight out of the
+merged graph, so they stay correct if you edit either file.
+
+Pass `-f` to skip the preflight (JSON validation still runs):
+
+```sh
+./apply.sh -f
+```
+
+---
+
+## 6. Confirm it loaded
+
+```sh
+wpctl status | grep -i "DSP Speakers"
+pw-cli ls Node | grep -i t2-151-speakers
+```
+
+Select **"MacBook Pro 15,1 DSP Speakers"** as the output (`wpctl set-default
+<id>`, or your DE's sound settings), then play something.
+
+To watch the plugins actually run / spot xruns:
+
+```sh
+pw-top        # look for the filter-chain node, check for XRUN
+```
+
+---
+
+## 7. Pick a sound profile
+
+`user_eq` is the first node in the graph — an 8-band tone control that defaults
+flat (= the reference voicing). To change it without touching the committed
+`graph.json`:
+
+```sh
+cp user_eq.example.json user_eq.json      # git-ignored
+$EDITOR user_eq.json                        # set the g_* values
+./apply.sh                                  # merges it into ~/.audiograph.json and installs
+```
+
+`jq` must be installed for this path. Delete `user_eq.json` to return to the
+default. Preset values (Rock, Classical, Movie–dialogue, …) are in
+[README.md § User preference EQ](README.md#user-preference-eq).
+
+---
+
+## 8. After a system update
+
+A `t2-linux-audio` package update **overwrites**
+`/usr/share/t2-linux-audio/15_1/graph.json` and silently reverts to the stock
+graph. Re-run `./apply.sh` afterward. (Plugin packages updating is fine — the
+graph only cares that the URIs still resolve.)
+
+---
+
+## 9. Revert to stock
+
+```sh
+sudo cp /path/to/t2-apple-audio-dsp/configs/15_1/graph.json \
+        /usr/share/t2-linux-audio/15_1/graph.json
+systemctl --user restart wireplumber
+```
+
+Or reinstall the t2 speaker-DSP package.
+
+---
+
+## Troubleshooting
+
+| Symptom | Likely cause | Fix |
+|---|---|---|
+| No "DSP Speakers" sink after apply | t2 speaker-DSP package / `51-t2-dsp.conf` not installed | §1 |
+| Sink present, but silent / falls back to another device | a plugin URI failed to load, so the whole filter-chain fails | §3c — find the `MISSING` line |
+| `wireplumber` won't start after apply | malformed `graph.json` | `python3 -m json.tool graph.json`; `journalctl --user -u wireplumber -b` |
+| Works, but no bass enhancement | `bankstown` (`virtualbass`) not loaded | §3b, then §3c |
+| Distortion when loud | drive too high for your unit — see [README.md § Tuning knobs](README.md#tuning-knobs) | lower `wlim.limit`, or the `user_eq` bass bands |
+| Reverted itself after an update | expected — see §8 | re-run `./apply.sh` |
--- a/README.advanced.md
+++ b/README.advanced.md
@@ -0,0 +1,296 @@
+# MacBook Pro 15,1 — custom speaker DSP graph
+
+A modified PipeWire `filter-chain` graph for the built-in speakers of the
+**MacBook Pro 15,1** (Intel T2) running Linux, plus a script to install it.
+
+This is **not a driver**. The T2 kernel/ALSA stack exposes the raw speaker PCM;
+WirePlumber (via `t2-linux-audio`'s `51-t2-dsp.conf`) renames it to
+`alsa_output.platform-sound.RawSpeakers`, hides it, and splices this graph in
+front of it. The graph does the crossover, voicing EQ, dynamics, and FIR
+correction that the T2's own DSP does under macOS.
+
+## Origin
+
+Forked from `configs/15_1/graph.json` in
+[lemmyg/t2-apple-audio-dsp](https://github.com/lemmyg/t2-apple-audio-dsp)
+(which itself borrows FIR filters and structure from
+[chadmed/asahi-audio](https://github.com/chadmed/asahi-audio)).
+
+All structural elements are unchanged: node names, FIR `.wav` paths
+(`/usr/share/t2-linux-audio/15_1/`), `capture.props` / `playback.props`,
+`target.object = alsa_output.platform-sound.RawSpeakers`, 4-channel FL/FR/RL/RR
+output, allowed rates 48000/44100, and the `capture.volumes` mapping that ties
+the sink volume slider to the loudness-compensation stage.
+
+## Prior art — why this fork
+
+Two recurring complaints about the upstream chains, from their own issue
+trackers and docs, motivated the changes here:
+
+**It sounds thin / not warm enough.** `asahi-audio` deliberately targets *"a
+mostly flat response ... without adding an excessive amount of colour"* and
+explicitly rejects Apple's *"exaggerated Harman curve."* Flat magnitude is
+equal-energy-per-*Hz*, which reads as bass-light against pink-balanced program
+material (see [Design rationale](#why-the-voicing-curve-exists--and-why-upstream-sounds-thin)).
+Users keep asking for the warmth back:
+
+- [asahi-audio #31](https://github.com/AsahiLinux/asahi-audio/issues/31) — request for a bass/treble ("smiley") curve + a guide to change it system-wide; closed with no documented answer.
+- [asahi-audio #93](https://github.com/AsahiLinux/asahi-audio/issues/93) — *"Lacks proper bass and high frequencies, sounding flat, thin, and muddy";* closed as not planned.
+- [t2-apple-audio-dsp #21](https://github.com/lemmyg/t2-apple-audio-dsp/issues/21) (direct upstream) — *"Quality is good but volume is quite low even at maximum volume."*
+- [Asahi audio docs](https://asahilinux.org/docs/sw/audio-userspace/) known issues: the 13″ MBA EQ *"might be a bit harsh on the treble."*
+
+**It distorts when loud, because there is no output limiter.** The Asahi docs
+state plainly: *"There is no final limiter/compressor in the current DSP
+chains"* (only an input compressor), so *"content in high-gain regions of the EQ
+curve might cause distortion or clipping."* They also flag *"the 200 Hz region"*
+for distortion risk and note `bankstown` is *"prone to saturation artifacts at
+high volumes."*
+
+- [asahi-audio #22](https://github.com/AsahiLinux/asahi-audio/issues/22) — j313 distortion at 100 %; traced to convolver gain being too hot, worked around by dropping it to ~0.6.
+- [asahi-audio #42](https://github.com/AsahiLinux/asahi-audio/issues/42) — J474 distortion above 72 % volume.
+- [asahi-audio #91](https://github.com/AsahiLinux/asahi-audio/issues/91) — j313 *"severe speaker distortion"* at 55 %; `speakersafetyd` logs nothing, i.e. it's in the signal processing, not the protection model.
+
+This fork's answers, point by point:
+
+| Upstream complaint | Change here |
+|---|---|
+| flat / thin / "not warm enough" | EQ bass tilt (≈ +3 dB/octave per-Hz) ahead of the dynamics |
+| no final limiter → clipping in high-gain EQ regions | `limiter` + post-FIR `wlim` / `tlim` on the real driver signal |
+| 200 Hz distortion risk | fine multiband split through the low-mids |
+| `bankstown` saturates at volume | EQ `g_in 0.5` pad + `sat_second` / `sat_third` reduced |
+| convolver gain too hot at 100 % (#22) | FIR kept near unity; drive lives in the dynamically-governed EQ |
+| "volume too low at max" (#21) | `g_out` makeup + loudness maximisation into the limiters |
+
+## Signal chain
+
+```
+in ─▶ user_eq ─▶ equalizer ─▶ virtualbass ─▶ multiband_compressor ─▶ limiter ─▶ ell/elr ─▶ copyL/R ─┬▶ convLT/convRT ─▶ tlim ─▶ out
+     (LSP x16)   (LSP x16)    (bankstown)   (LSP mb_comp x8)      (fastLookahead) (loud_comp)        │  (tweeter FIR)   (limit)
+     user prefs  voicing                                                                             └▶ convLW/convRW ─▶ wlim ─▶ out
+                                                                                                        (woofer FIR)    (limit)
+```
+
+## Changes vs. upstream `15_1/graph.json`
+
+| Stage | Upstream | This fork | Purpose |
+|---|---|---|---|
+| Pre-EQ | *none* | LSP `para_equalizer_x16_stereo`, `g_in 0.5` | Warm/bass-forward voicing curve |
+| Gain staging | n/a | EQ `g_in` padded to 0.5 (≈ −6 dB); the ~3 dB net loss restored at `multiband_compressor.g_out 1.4`, with band thresholds `al_*` scaled to match | Run the EQ + `virtualbass` cooler; recover level only after the compressor detectors, right before the limiter |
+| EQ band 0 | n/a | 48 dB/oct **high-pass @ 60 Hz** (`ft_0 2`, `s_0 3`) | Kill everything below the woofer's usable range — −3 dB at 60 Hz, ≈ −30 dB by 40 Hz |
+| Dynamics | single-band `compressor_stereo` | `mb_compressor_stereo`, **8 bands** (xover 60/80/100/130/160/200/500 Hz), Modern mode | Per-band peak control that doesn't duck the mids on a bass beat; the woofer range is split finely (five bands 60–200 Hz) so the 60–80 and 80–100 Hz octaves can be clamped harder than the rest |
+| Woofer FIR gain | `1.0` | `1.15` (`convLW` / `convRW`) | Small trim only; the low-end drive now lives in the EQ bass bells (upstream, so it passes through the compressor + limiters instead of being an uncontrolled post-gain) |
+| Bass EQ bells | n/a | 31.5–200 Hz boosted ~+2.3 dB above the base warm tilt to offset the FIR gain reduction | Same woofer output level, but dynamically governed |
+| Post-FIR limiters | *none* | `wlim` (−2 dB) after woofer FIR, `tlim` (−1 dB) after tweeter FIR | Hard ceiling on the *actual* driver signal — excursion / clip backstop |
+
+Everything else is byte-identical to upstream.
+
+## Design rationale
+
+**Goal:** mild-volume music should sound warm and full; bass-heavy material
+should not distort the woofers or duck the midrange.
+
+### Why the voicing curve exists — and why upstream sounds thin
+
+Music is mastered for systems with a roughly **equal-energy-per-octave** (pink)
+balance and the headroom to reproduce it. The forked FIR filters (`asahi-audio` /
+`t2-apple-audio-dsp`) correct the drivers to **flat magnitude = equal energy per
+_Hz_** — measurement-correct, but each octave down then carries the same per-Hz
+energy across half the bandwidth, so it lands **bass-light** ("not warm enough").
+Matching the per-octave balance needs ≈ **+3 dB/octave** of per-Hz lift toward the
+lows — that is what the EQ bass bells are for.
+
+That tilt can't be static. The two things it can break are different above and
+below **~150 Hz**:
+
+| Region | Failure mode | Scaling | Guarded by |
+|---|---|---|---|
+| **< ~150 Hz** | woofer **over-excursion** — cone bottoms out | displacement ∝ 1/f² ≈ **+12 dB/octave** for constant SPL | fine multiband split (one limiter per bass octave, held release) + the 20 Hz subsonic HPF; `virtualbass` supplies deep sub as harmonics so the cone never has to move for it |
+| **> ~150 Hz** | **over-voltage** — demanded level exceeds the amp's max swing to the cone | ≈ flat (voltage/thermal, not displacement) | multiband peak control per band, then `limiter` / `wlim` / `tlim` as backstop |
+
+The `fastLookaheadLimiter` stages are a *second* line of defence only, because
+they are **broadband**: when one triggers it ducks every frequency at once, so a
+loud trombone transient pulls the violins down with it. The multiband compressor
+is the *first* line precisely because its gain reduction stays inside the
+offending band — the more work it does, the less the broadband limiters engage
+and the cleaner the result. Net: full warmth at low level, graceful flattening
+toward the FIR's flat-per-Hz curve as it gets loud, with cheap pitch-reinforcing
+harmonic distortion traded for ugly (and mechanically risky) excursion
+distortion.
+
+### Warm at low volume
+
+- **Warm at low volume** is handled two ways:
+  - `ell` / `elr` (`loud_comp_mono`) is a true ISO-226 equal-loudness
+    compensator. The sink volume slider feeds `ell:volume` / `elr:volume`
+    (cubic, −65→0 dB), so bass/treble lift automatically increases as you turn
+    the volume down and recedes as you turn it up.
+  - The static EQ bells (31.5–125 Hz) add a fixed warmth tilt. Note LSP's `g_*`
+    ports are **linear amplitude, not dB** — `g_3 = 3.26` is ≈ +10 dB, offset by
+    `g_in 0.5` (≈ −6 dB). This is a hot bass shelf on purpose; the dynamics
+    stages below exist to keep it safe when loud. The bass boost lives here
+    rather than in the woofer FIR gain (kept near unity at 1.15) so it passes
+    through the compressor and limiters and is dynamically controlled, instead
+    of being a fixed post-everything gain that only `wlim` can catch.
+
+- **Gain staging.** `g_in` on the EQ is padded to 0.5 so the boosted bands and
+  `virtualbass`'s saturation stages run with headroom rather than near/over
+  0 dBFS. The signal path is 32-bit float end-to-end (real clipping only happens
+  at the ALSA sink), but a cooler operating point keeps `virtualbass` from being
+  over-driven and keeps every plugin's internal detectors honest. The ~3 dB net
+  level loss is put back at `multiband_compressor.g_out` (1.0 → 1.4) — *after*
+  the band detectors, immediately before the main limiter — and the band
+  thresholds `al_*` were scaled by the same factor so the compressor behaves
+  exactly as before, just at a lower internal level.
+
+- **Bass beats don't distort** is handled by multiband, not broadband,
+  compression. A single-band compressor keyed off a kick drum applies gain
+  reduction to the *whole* spectrum — vocals and mids pump on every beat, and
+  loud bass can shut the woofers down across all frequencies. The 8-band
+  multiband keeps each band responding only to its own energy. The seven bands
+  below ~500 Hz — where over-excursion and boom live — are effectively limiters:
+
+  | Band | Range | `cr` | `kn` | `al` (≈ dB) | Note |
+  |---|---|---|---|---|---|
+  | 0 | < 60 Hz | 50 | 0.10 | 0.093 (−21) | catch band — mostly empty now that the EQ HPFs hard at 60 Hz |
+  | 1 | 60–80 Hz | 50 | 0.06 | 0.078 (−22) | hardest clamp — lowest ceiling, highest ratio, widest (softest) knee so the 50:1 eases in |
+  | 2 | 80–100 Hz | 30 | 0.12 | 0.095 (−20) | clamped harder than the rest, a step gentler than 60–80 |
+  | 3 | 100–130 Hz | 20 | 0.20 | 0.120 (−18) | midbass, as the old 90–200 band |
+  | 4 | 130–160 Hz | 18 | 0.24 | 0.130 (−18) | |
+  | 5 | 160–200 Hz | 16 | 0.28 | 0.140 (−17) | |
+  | 6 | 200–500 Hz | 15 | 0.30 | 0.159 (−16) | low-mid body, as the old 200–500 band |
+  | 7 | 500 Hz+ | 5 | 0.40 | 0.284 (−11) | single gentle band above 500 Hz (was three: 500/1500/5000) |
+
+  (Every `mb_compressor` port is documented in
+  [mb-compressor-params.md](mb-compressor-params.md).)
+
+  Band 1 (60–80 Hz) and band 2 (80–100 Hz) carry the lowest ceilings and the
+  highest ratios, so the two octaves that drive woofer excursion hardest are
+  clamped ahead of everything else — their wide knees (`kn` down at `0.06` /
+  `0.12`, i.e. −24 / −18 dB) make that heavy ratio ramp in gradually rather than
+  snap. Band 7 limits gently (`cr 5`) and does not
+  move because of a kick drum. The EQ is left untouched, so anything below the
+  thresholds — i.e. quiet listening — passes with its full warm tilt intact;
+  only loud peaks are clamped.
+
+- **Woofers can't bottom out.** The woofer FIR is near unity now (`1.15`), but
+  `loud_comp` still adds bass gain after the main limiter, so the very last
+  stage is unguarded. `wlim` / `tlim` are `fastLookaheadLimiter` instances placed
+  *after* the convolvers, so they clamp the real signal the drivers see
+  regardless of upstream gain. `wlim` at −2 dB is the mechanical-excursion
+  backstop; `tlim` at −1 dB protects the tweeters and keeps the two paths
+  time-aligned (equal lookahead latency — no comb filtering at the crossover).
+
+- **`virtualbass` (bankstown)** synthesizes harmonics of the bass in the
+  60–150 Hz window, so the ear perceives low end the driver never has to
+  physically produce — the psychoacoustic counterpart to the 60 Hz high-pass.
+
+## User preference EQ
+
+`user_eq` is the **first node in the graph** and the only block meant for
+hand-editing — a plain 8-band tone control for matching the sound to content
+type. It defaults **flat** (every `g_*` = `1.0`), which *is* the reference
+voicing; editing it never touches the calibrated `equalizer` / dynamics below.
+Because it sits ahead of the compressor and limiters, even an aggressive preset
+is dynamically governed — it can't clip or over-excurse, it just gets
+compressed if pushed hard.
+
+| Band | `f` | Type | Region |
+|---|---|---|---|
+| 0 | 70 Hz | low shelf | sub weight / rumble |
+| 1 | 110 Hz | bell | bass punch |
+| 2 | 220 Hz | bell | warmth / boom |
+| 3 | 450 Hz | bell | body / mud |
+| 4 | 1 kHz | bell | mids / nasal |
+| 5 | 2.5 kHz | bell | presence / attack |
+| 6 | 6 kHz | bell | detail / sibilance |
+| 7 | 10 kHz | high shelf | air |
+
+Values are **linear, not dB** (`+3 dB ≈ 1.41`, `−3 dB ≈ 0.71`). Keep each `g_*`
+between `0.5` (−6 dB) and `2.0` (+6 dB).
+
+Two ways to set it, both followed by `./apply.sh`:
+
+- **Override file (recommended, survives `git pull`).** Copy the template and
+  edit it:
+  ```sh
+  cp user_eq.example.json user_eq.json
+  $EDITOR user_eq.json
+  ```
+  `user_eq.json` is git-ignored. When present, `apply.sh` splices its contents
+  into the `user_eq` node's `control` block with `jq`, writes the result to
+  `~/.audiograph.json`, and installs that. Delete `user_eq.json` to go back to
+  the committed default.
+- **Edit `graph.json` directly** — change the `g_*` in the `user_eq` `control`
+  block. Simple, but a `git pull` will conflict.
+
+### Presets — the 8 `g_*` values, `g_0`…`g_7`
+
+| Preset | 70 | 110 | 220 | 450 | 1k | 2.5k | 6k | 10k |
+|---|---|---|---|---|---|---|---|---|
+| **Reference** (flat) | 1.00 | 1.00 | 1.00 | 1.00 | 1.00 | 1.00 | 1.00 | 1.00 |
+| Rock / Pop | 1.00 | 1.26 | 1.00 | 0.94 | 1.00 | 1.12 | 1.19 | 1.12 |
+| Classical / Acoustic | 1.00 | 1.00 | 1.06 | 1.00 | 1.00 | 1.00 | 1.12 | 1.12 |
+| Electronic / Hip-Hop | 1.26 | 1.19 | 1.00 | 0.94 | 1.00 | 1.00 | 1.06 | 1.00 |
+| Movie — dialogue | 0.84 | 0.94 | 1.00 | 1.06 | 1.19 | 1.19 | 1.06 | 1.00 |
+| Movie — action | 1.41 | 1.12 | 1.00 | 1.00 | 1.00 | 1.06 | 1.12 | 1.12 |
+| Late-night (low level) | 0.63 | 0.79 | 1.00 | 1.00 | 1.06 | 1.12 | 1.00 | 0.94 |
+
+## Tuning knobs
+
+If the woofers still bottom out or anything distorts, in order of preference:
+
+| Where | Key | Now | Effect |
+|---|---|---|---|
+| `wlim.control` | `limit` | `-2` | Lower to `-3` / `-4` — hard woofer ceiling, dB |
+| `equalizer.control` | `g_1`–`g_5` | `1.82 / 2.48 / 3.26 / 2.61 / 1.75` | The bass boost — lower all five proportionally for less low-end drive overall |
+| `convLW` / `convRW` `config` | `gain` | `1.15` | FIR trim; leave it — adjust the EQ bells instead |
+| `multiband_compressor.control` | `al_0` | `0.093` (≈ −21 dB) | Lower = < 60 Hz band clamps sooner |
+| `multiband_compressor.control` | `al_1` / `al_2` | `0.078` / `0.095` | The 60–80 / 80–100 Hz ceilings — lower these two to pull the peak down further in those octaves |
+| `multiband_compressor.control` | `cr_1` / `kn_1` | `50.0` / `0.06` | 60–80 Hz clamp — highest ratio, widest knee. Less aggressive: lower `cr_1` toward `20`. Sharper corner / less low-level squash: raise `kn_1` toward `1.0` |
+| `multiband_compressor.control` | `cr_2` / `kn_2` | `30.0` / `0.12` | 80–100 Hz clamp — a step gentler than 60–80 |
+| `multiband_compressor.control` | `cr_0` | `50.0` | Already near brick-wall; leave it |
+| `multiband_compressor.control` | `at_0` | `4.0` ms | Lower toward ~3 ms if kick transients poke through (adds some LF harmonic distortion) |
+
+If the midrange sounds over-controlled / lifeless, raise `al_3`–`al_7` (higher =
+those bands stay out of the way longer) or lower their ratios `cr_3`–`cr_7`
+toward `2.0`. Band 6 (200–500 Hz) at `cr 15` reaches into low-mid body — if male
+vocals / snare sound boxy or thin, drop `cr_6` back toward `8`.
+
+**Gain staging.** To run the EQ / `virtualbass` even cooler, lower
+`equalizer.g_in` further (e.g. `0.4`, `0.35`) and put the same factor back into
+`multiband_compressor.g_out`, then scale `al_0`–`al_7` by that factor so the
+compressor keeps the same behaviour. If bass feels thinner after the pad, nudge
+`virtualbass.amt` up (`1.0` → `1.2`) rather than raising `g_in` back.
+
+`tlim.control` `limit` (`-1`) is the tweeter ceiling — rarely needs touching, but
+**keep `tlim` present even if you disable it** (`limit` high), because it also
+holds the tweeter/woofer time alignment.
+
+## Install
+
+Full instructions — prerequisites, the LV2 plugin dependencies (LSP, SWH, and a
+source build of Bankstown), the FIR files, verification and troubleshooting —
+are in **[INSTALL.md](INSTALL.md)**.
+
+Short version, with the `t2-linux-audio` / `t2-apple-audio-dsp` package already
+installed (it provides the FIR `.wav` files, `51-t2-dsp.conf` and `mic.json`):
+
+```sh
+./install-deps.sh   # LSP + SWH plugins, builds Bankstown from source
+./apply.sh          # preflights, then copies the graph in and reloads WirePlumber
+```
+
+`apply.sh` refuses to install if a referenced FIR file or plugin URI is missing
+(`-f` skips those checks).
+
+## Revert
+
+```sh
+sudo cp /path/to/t2-apple-audio-dsp/configs/15_1/graph.json \
+        /usr/share/t2-linux-audio/15_1/graph.json
+systemctl --user restart wireplumber
+```
+
+Note: a `t2-linux-audio` package update will overwrite the installed file and
+silently revert these changes — re-run `./apply.sh` afterward. See
+[INSTALL.md § 8](INSTALL.md#8-after-a-system-update).
--- a/README.md
+++ b/README.md
@@ -1,171 +1,157 @@
-# MacBook Pro 15,1 — custom speaker DSP graph
+# MacBook Pro 15,1 — Warm, Natural Audio DSP for t2linux

-A modified PipeWire `filter-chain` graph for the built-in speakers of the
-**MacBook Pro 15,1** (Intel T2) running Linux, plus a script to install it.
+[![GitHub Repository](https://img.shields.io/badge/Repository-GitHub-181717.svg?logo=github)](https://github.com/mynameisdeleted/mbp15-1-audio-dsp) [![Fairfax Media Git](https://img.shields.io/badge/Repository-Fairfax%20Media-003366.svg)](https://git.fairfaxmedia.net/t2linux/mbp15-1-audio-dsp.git) [![t2linux](https://img.shields.io/badge/Platform-t2linux-blue.svg)](https://wiki.t2linux.org/) [![Asahi Audio Ecosystem](https://img.shields.io/badge/Ecosystem-Asahi%20Audio-orange.svg)](https://github.com/AsahiLinux/asahi-audio) [![PipeWire](https://img.shields.io/badge/Audio-PipeWire%20%2F%20WirePlumber-red.svg)](https://pipewire.org/) [![Target Hardware](https://img.shields.io/badge/Hardware-MacBook%20Pro%2015%2C1-black.svg)]()

-This is **not a driver**. The T2 kernel/ALSA stack exposes the raw speaker PCM;
-WirePlumber (via `t2-linux-audio`'s `51-t2-dsp.conf`) renames it to
-`alsa_output.platform-sound.RawSpeakers`, hides it, and splices this graph in
-front of it. The graph does the crossover, voicing EQ, dynamics, and FIR
-correction that the T2's own DSP does under macOS.
+A custom PipeWire `filter-chain` DSP graph engineered to deliver warm, natural audio to **t2linux** on the **MacBook Pro 15,1** (2018/2019 Intel T2)—aimed at matching or beating macOS (OS X) audio quality both subjectively and objectively.

-## Origin
+> [!NOTE]
+> **Architecture:** This is **not a kernel driver**. The Linux T2 kernel/ALSA stack exposes raw speaker PCM. WirePlumber hides the raw device and splices this graph in front of it (`alsa_output.platform-sound.RawSpeakers`), executing warm voicing EQ, psychoacoustic sub-bass, 8-band dynamic control, driver crossover, FIR correction, and hard driver protection limiters.

-Forked from `configs/15_1/graph.json` in
-[lemmyg/t2-apple-audio-dsp](https://github.com/lemmyg/t2-apple-audio-dsp)
-(which itself borrows FIR filters and structure from
-[chadmed/asahi-audio](https://github.com/chadmed/asahi-audio)).
+---

-All structural elements are unchanged: node names, FIR `.wav` paths
-(`/usr/share/t2-linux-audio/15_1/`), `capture.props` / `playback.props`,
-`target.object = alsa_output.platform-sound.RawSpeakers`, 4-channel FL/FR/RL/RR
-output, allowed rates 48000/44100, and the `capture.volumes` mapping that ties
-the sink volume slider to the loudness-compensation stage.
+## ⚡ Key Improvements Over Upstream

-## Signal chain
+Upstream graphs (`asahi-audio` / `t2-apple-audio-dsp`) target a measurement-flat response that can sound thin, treble-heavy, and distort at high volumes due to missing driver limiters.

-```
-in ─▶ equalizer ─▶ virtualbass ─▶ multiband_compressor ─▶ limiter ─▶ ell/elr ─▶ copyL/R ─┬▶ convLT/convRT ─▶ tlim ─▶ out
-     (LSP x16)     (bankstown)   (LSP mb_comp x8)      (fastLookahead) (loud_comp)        │  (tweeter FIR)   (limit)
-                                                                                          └▶ convLW/convRW ─▶ wlim ─▶ out
-                                                                                             (woofer FIR)    (limit)
+| Upstream Limitation | Solution in This Graph | Real-World Result |
+|---|---|---|
+| ❄️ **Thin / Cold Sound** | Equal-energy warm voicing curve (+3 dB/octave tilt) | Rich, full, balanced audio across all genres |
+| 💥 **Distortion at High Volume** | Post-FIR driver limiters (`wlim` @ -2dB, `tlim` @ -1dB) | Crystal clean output at 100% volume with zero amp clipping |
+| 🔊 **Woofer Over-Excursion** | 60 Hz high-pass + 8-band multiband compressor | Woofers don't bottom out or rattle on heavy bass beats |
+| 🔇 **No Deep Sub-Bass** | Psychoacoustic sub-bass (`virtualbass` via Bankstown) | Extended perceived low-end without physical cone strain |
+| 🎚️ **Fixed / Rigid EQ** | Isolated 8-band `user_eq` preference node | Custom tone presets that survive git updates |
+
+---
+
+## 🎛️ Signal Processing Chain
+
+Audio flows through tone controls, dynamic management, ISO-226 equal loudness tracking, FIR driver correction, and physical driver protection limiters:
+
+```mermaid
+flowchart TD
+    subgraph Stage1 ["1. Input & Voicing"]
+        In["🔊 Audio Input"]:::input --> UserEQ["🎚️ User EQ (8-Band Tone Control)"]:::eq
+        UserEQ --> EQ["🎼 Voicing EQ (+3dB/oct Warmth & 60Hz HPF)"]:::eq
+    end
+
+    subgraph Stage2 ["2. Dynamics & Headroom Management"]
+        EQ --> VB["🔊 Virtual Bass (Bankstown Sub-Harmonics)"]:::dynamics
+        VB --> MBComp["📊 Multiband Compressor (8-Band LSP)"]:::dynamics
+        MBComp --> Limiter["🛡️ Main Limiter (Broadband Lookahead)"]:::limiter
+        Limiter --> LoudComp["👂 Loudness Comp (ISO-226 Equal Loudness)"]:::dynamics
+    end
+
+    subgraph Stage3 ["3. Crossover & Driver FIR Correction"]
+        LoudComp --> Copy["🔀 4-Channel Crossover Splitter"]:::input
+        
+        subgraph Tweeters ["Tweeter Channels"]
+            Copy --> ConvLT["🔊 Tweeter L FIR (convLT)"]:::fir
+            Copy --> ConvRT["🔊 Tweeter R FIR (convRT)"]:::fir
+        end
+        
+        subgraph Woofers ["Woofer Channels"]
+            Copy --> ConvLW["🔊 Woofer L FIR (convLW)"]:::fir
+            Copy --> ConvRW["🔊 Woofer R FIR (convRW)"]:::fir
+        end
+    end
+
+    subgraph Stage4 ["4. Driver Safety Backstops & Output"]
+        ConvLT --> TLim["🛡️ Tweeter Limiter (-1 dB Ceiling)"]:::limiter
+        ConvRT --> TLim
+        ConvLW --> WLim["🛡️ Woofer Limiter (-2 dB Ceiling)"]:::limiter
+        ConvRW --> WLim
+
+        TLim --> Out["🔈 RawSpeakers Sink"]:::input
+        WLim --> Out
+    end
+
+    classDef input fill:#2d3748,stroke:#4a5568,color:#fff;
+    classDef eq fill:#2b6cb0,stroke:#3182ce,color:#fff;
+    classDef dynamics fill:#d69e2e,stroke:#d69e2e,color:#000;
+    classDef fir fill:#805ad5,stroke:#9f7aea,color:#fff;
+    classDef limiter fill:#c53030,stroke:#e53e3e,color:#fff;
 ```

-## Changes vs. upstream `15_1/graph.json`
+---

-| Stage | Upstream | This fork | Purpose |
-|---|---|---|---|
-| Pre-EQ | *none* | LSP `para_equalizer_x16_stereo`, `g_in 0.5` | Warm/bass-forward voicing curve |
-| Gain staging | n/a | EQ `g_in` padded to 0.5 (≈ −6 dB); the ~3 dB net loss restored at `multiband_compressor.g_out 1.4`, with band thresholds `al_*` scaled to match | Run the EQ + `virtualbass` cooler; recover level only after the compressor detectors, right before the limiter |
-| EQ band 0 | n/a | 48 dB/oct **high-pass @ 60 Hz** (`ft_0 2`, `s_0 3`) | Kill everything below the woofer's usable range — −3 dB at 60 Hz, ≈ −30 dB by 40 Hz |
-| Dynamics | single-band `compressor_stereo` | `mb_compressor_stereo`, **8 bands** (xover 60/80/100/130/160/200/500 Hz), Modern mode | Per-band peak control that doesn't duck the mids on a bass beat; the woofer range is split finely (five bands 60–200 Hz) so the 60–80 and 80–100 Hz octaves can be clamped harder than the rest |
-| Woofer FIR gain | `1.0` | `1.15` (`convLW` / `convRW`) | Small trim only; the low-end drive now lives in the EQ bass bells (upstream, so it passes through the compressor + limiters instead of being an uncontrolled post-gain) |
-| Bass EQ bells | n/a | 31.5–200 Hz boosted ~+2.3 dB above the base warm tilt to offset the FIR gain reduction | Same woofer output level, but dynamically governed |
-| Post-FIR limiters | *none* | `wlim` (−2 dB) after woofer FIR, `tlim` (−1 dB) after tweeter FIR | Hard ceiling on the *actual* driver signal — excursion / clip backstop |
+## 🚀 Quick Start

-Everything else is byte-identical to upstream.
+### 1. Install Dependencies
+Installs required LSP & SWH plugins via your package manager (`dnf`, `pacman`, `apt`, `zypper`) and builds Bankstown from source:
+```bash
+./install-deps.sh
+```

-## Design rationale
-
-**Goal:** mild-volume music should sound warm and full; bass-heavy material
-should not distort the woofers or duck the midrange.
-
- **Warm at low volume** is handled two ways:
-  - `ell` / `elr` (`loud_comp_mono`) is a true ISO-226 equal-loudness
-    compensator. The sink volume slider feeds `ell:volume` / `elr:volume`
-    (cubic, −65→0 dB), so bass/treble lift automatically increases as you turn
-    the volume down and recedes as you turn it up.
-  - The static EQ bells (31.5–125 Hz) add a fixed warmth tilt. Note LSP's `g_*`
-    ports are **linear amplitude, not dB** — `g_3 = 3.26` is ≈ +10 dB, offset by
-    `g_in 0.5` (≈ −6 dB). This is a hot bass shelf on purpose; the dynamics
-    stages below exist to keep it safe when loud. The bass boost lives here
-    rather than in the woofer FIR gain (kept near unity at 1.15) so it passes
-    through the compressor and limiters and is dynamically controlled, instead
-    of being a fixed post-everything gain that only `wlim` can catch.
-
- **Gain staging.** `g_in` on the EQ is padded to 0.5 so the boosted bands and
-  `virtualbass`'s saturation stages run with headroom rather than near/over
-  0 dBFS. The signal path is 32-bit float end-to-end (real clipping only happens
-  at the ALSA sink), but a cooler operating point keeps `virtualbass` from being
-  over-driven and keeps every plugin's internal detectors honest. The ~3 dB net
-  level loss is put back at `multiband_compressor.g_out` (1.0 → 1.4) — *after*
-  the band detectors, immediately before the main limiter — and the band
-  thresholds `al_*` were scaled by the same factor so the compressor behaves
-  exactly as before, just at a lower internal level.
-
- **Bass beats don't distort** is handled by multiband, not broadband,
-  compression. A single-band compressor keyed off a kick drum applies gain
-  reduction to the *whole* spectrum — vocals and mids pump on every beat, and
-  loud bass can shut the woofers down across all frequencies. The 8-band
-  multiband keeps each band responding only to its own energy. The seven bands
-  below ~500 Hz — where over-excursion and boom live — are effectively limiters:
-
-  | Band | Range | `cr` | `kn` | `al` (≈ dB) | Note |
-  |---|---|---|---|---|---|
-  | 0 | < 60 Hz | 50 | 0.10 | 0.093 (−21) | catch band — mostly empty now that the EQ HPFs hard at 60 Hz |
-  | 1 | 60–80 Hz | 50 | 0.06 | 0.078 (−22) | hardest clamp — lowest ceiling, highest ratio, widest (softest) knee so the 50:1 eases in |
-  | 2 | 80–100 Hz | 30 | 0.12 | 0.095 (−20) | clamped harder than the rest, a step gentler than 60–80 |
-  | 3 | 100–130 Hz | 20 | 0.20 | 0.120 (−18) | midbass, as the old 90–200 band |
-  | 4 | 130–160 Hz | 18 | 0.24 | 0.130 (−18) | |
-  | 5 | 160–200 Hz | 16 | 0.28 | 0.140 (−17) | |
-  | 6 | 200–500 Hz | 15 | 0.30 | 0.159 (−16) | low-mid body, as the old 200–500 band |
-  | 7 | 500 Hz+ | 5 | 0.40 | 0.284 (−11) | single gentle band above 500 Hz (was three: 500/1500/5000) |
-
-  (Every `mb_compressor` port is documented in
-  [mb-compressor-params.md](mb-compressor-params.md).)
-
-  Band 1 (60–80 Hz) and band 2 (80–100 Hz) carry the lowest ceilings and the
-  highest ratios, so the two octaves that drive woofer excursion hardest are
-  clamped ahead of everything else — their wide knees (`kn` down at `0.06` /
-  `0.12`, i.e. −24 / −18 dB) make that heavy ratio ramp in gradually rather than
-  snap. Band 7 limits gently (`cr 5`) and does not
-  move because of a kick drum. The EQ is left untouched, so anything below the
-  thresholds — i.e. quiet listening — passes with its full warm tilt intact;
-  only loud peaks are clamped.
-
- **Woofers can't bottom out.** The woofer FIR is near unity now (`1.15`), but
-  `loud_comp` still adds bass gain after the main limiter, so the very last
-  stage is unguarded. `wlim` / `tlim` are `fastLookaheadLimiter` instances placed
-  *after* the convolvers, so they clamp the real signal the drivers see
-  regardless of upstream gain. `wlim` at −2 dB is the mechanical-excursion
-  backstop; `tlim` at −1 dB protects the tweeters and keeps the two paths
-  time-aligned (equal lookahead latency — no comb filtering at the crossover).
-
- **`virtualbass` (bankstown)** synthesizes harmonics of the bass in the
-  60–150 Hz window, so the ear perceives low end the driver never has to
-  physically produce — the psychoacoustic counterpart to the 60 Hz high-pass.
-
-## Tuning knobs
-
-If the woofers still bottom out or anything distorts, in order of preference:
-
-| Where | Key | Now | Effect |
-|---|---|---|---|
-| `wlim.control` | `limit` | `-2` | Lower to `-3` / `-4` — hard woofer ceiling, dB |
-| `equalizer.control` | `g_1`–`g_5` | `1.82 / 2.48 / 3.26 / 2.61 / 1.75` | The bass boost — lower all five proportionally for less low-end drive overall |
-| `convLW` / `convRW` `config` | `gain` | `1.15` | FIR trim; leave it — adjust the EQ bells instead |
-| `multiband_compressor.control` | `al_0` | `0.093` (≈ −21 dB) | Lower = < 60 Hz band clamps sooner |
-| `multiband_compressor.control` | `al_1` / `al_2` | `0.078` / `0.095` | The 60–80 / 80–100 Hz ceilings — lower these two to pull the peak down further in those octaves |
-| `multiband_compressor.control` | `cr_1` / `kn_1` | `50.0` / `0.06` | 60–80 Hz clamp — highest ratio, widest knee. Less aggressive: lower `cr_1` toward `20`. Sharper corner / less low-level squash: raise `kn_1` toward `1.0` |
-| `multiband_compressor.control` | `cr_2` / `kn_2` | `30.0` / `0.12` | 80–100 Hz clamp — a step gentler than 60–80 |
-| `multiband_compressor.control` | `cr_0` | `50.0` | Already near brick-wall; leave it |
-| `multiband_compressor.control` | `at_0` | `4.0` ms | Lower toward ~3 ms if kick transients poke through (adds some LF harmonic distortion) |
-
-If the midrange sounds over-controlled / lifeless, raise `al_3`–`al_7` (higher =
-those bands stay out of the way longer) or lower their ratios `cr_3`–`cr_7`
-toward `2.0`. Band 6 (200–500 Hz) at `cr 15` reaches into low-mid body — if male
-vocals / snare sound boxy or thin, drop `cr_6` back toward `8`.
-
-**Gain staging.** To run the EQ / `virtualbass` even cooler, lower
-`equalizer.g_in` further (e.g. `0.4`, `0.35`) and put the same factor back into
-`multiband_compressor.g_out`, then scale `al_0`–`al_7` by that factor so the
-compressor keeps the same behaviour. If bass feels thinner after the pad, nudge
-`virtualbass.amt` up (`1.0` → `1.2`) rather than raising `g_in` back.
-
-`tlim.control` `limit` (`-1`) is the tweeter ceiling — rarely needs touching, but
-**keep `tlim` present even if you disable it** (`limit` high), because it also
-holds the tweeter/woofer time alignment.
-
-## Install
-
-```sh
+### 2. Apply Graph
+Preflights FIR paths and plugin URIs, merges user EQ overrides, copies the configuration to WirePlumber, and reloads:
+```bash
 ./apply.sh
 ```

-This copies `graph.json` to `/usr/share/t2-linux-audio/15_1/graph.json` (needs
-`sudo`) and restarts WirePlumber (`systemctl --user restart wireplumber`).
+> [!TIP]
+> Ensure **"MacBook Pro 15,1 DSP Speakers"** is selected as the default output in your desktop sound settings.

-Requires the `t2-linux-audio` / `t2-apple-audio-dsp` package to already be
-installed (it provides the FIR `.wav` files, `51-t2-dsp.conf`, and the
-`mic.json` graph).
+---

-## Revert
+## 🎚️ Sound Profiles & User EQ

-```sh
+Customize tone settings without touching calibrated internal DSP nodes. `user_eq` sits at the front of the chain, so even aggressive boosts are safely governed by downstream multiband limiters.
+
+### Quick Preset Setup
+
+1. **Create your override file:**
+   ```bash
+   cp user_eq.example.json user_eq.json
+   ```
+2. **Edit `user_eq.json`** with your preferred gain multipliers (`g_0` to `g_7`) and apply:
+   ```bash
+   ./apply.sh
+   ```
+
+### Recommended Tone Presets
+
+| Profile | 70 Hz (`g_0`) | 110 Hz (`g_1`) | 220 Hz (`g_2`) | 450 Hz (`g_3`) | 1 kHz (`g_4`) | 2.5 kHz (`g_5`) | 6 kHz (`g_6`) | 10 kHz (`g_7`) |
+|---|---|---|---|---|---|---|---|---|
+| **Reference (Flat)** | `1.00` | `1.00` | `1.00` | `1.00` | `1.00` | `1.00` | `1.00` | `1.00` |
+| **Rock / Pop** | `1.00` | `1.26` | `1.00` | `0.94` | `1.00` | `1.12` | `1.19` | `1.12` |
+| **Classical / Acoustic** | `1.00` | `1.00` | `1.06` | `1.00` | `1.00` | `1.00` | `1.12` | `1.12` |
+| **Electronic / Hip-Hop** | `1.26` | `1.19` | `1.00` | `0.94` | `1.00` | `1.00` | `1.06` | `1.00` |
+| **Movie (Dialogue Focus)**| `0.84` | `0.94` | `1.00` | `1.06` | `1.19` | `1.19` | `1.06` | `1.00` |
+| **Movie (Action / Bass)** | `1.41` | `1.12` | `1.00` | `1.00` | `1.00` | `1.06` | `1.12` | `1.12` |
+| **Late-Night (Low Level)** | `0.63` | `0.79` | `1.00` | `1.00` | `1.06` | `1.12` | `1.00` | `0.94` |
+
+*(Note: Gain values are linear multipliers: `1.0` = 0 dB, `1.41` ≈ +3 dB boost, `0.71` ≈ -3 dB cut)*
+
+---
+
+## 🛠️ Fine-Tuning Guide
+
+If your specific physical unit requires custom acoustic tuning:
+
+* **Woofer Ceiling:** Edit `wlim.control.limit` in `graph.json` (Default: `-2` dB. Lower to `-3` / `-4` dB for stricter mechanical protection).
+* **Bass Drive:** Adjust `equalizer.control` (`g_1` through `g_5`).
+* **Sub-Bass Synthesis:** Adjust `virtualbass.control.amt` (Default: `1.0`).
+
+---
+
+## 📚 Documentation & Repository Links
+
+### 🔗 Repositories & Mirrors
+* 🐙 **GitHub Repository:** [github.com/mynameisdeleted/mbp15-1-audio-dsp](https://github.com/mynameisdeleted/mbp15-1-audio-dsp)
+* 🏢 **Fairfax Media Git Server:** [git.fairfaxmedia.net/t2linux/mbp15-1-audio-dsp](https://git.fairfaxmedia.net/t2linux/mbp15-1-audio-dsp.git)
+
+### 📖 Guides & Deep Dives
+* 📖 **[INSTALL.md](INSTALL.md)** — Full prerequisites, manual plugin build steps, package manager lookup, and troubleshooting.
+* 🎓 **[README.advanced.md](README.advanced.md)** — Comprehensive electroacoustic design rationale, magnitude-vs-power physics, gain staging equations, issue tracebacks, and complete parameter reference.
+* 📊 **[mb-compressor-params.md](mb-compressor-params.md)** — Detailed parameter guide for the 8-band LSP multiband compressor.
+
+---
+
+## 🔄 Reverting to Stock
+
+To return to the stock PipeWire graph provided by `t2-apple-audio-dsp`:
+```bash
 sudo cp /path/to/t2-apple-audio-dsp/configs/15_1/graph.json \
        /usr/share/t2-linux-audio/15_1/graph.json
 systemctl --user restart wireplumber
 ```
-
-Note: a `t2-linux-audio` package update will overwrite the installed file and
-silently revert these changes — re-run `./apply.sh` afterward.
--- a/apply.sh
+++ b/apply.sh
@@ -1,19 +1,193 @@
 #!/bin/bash
-# Apply script for MacBook Pro 15,1 audio DSP graph edits
+# Apply the MacBook Pro 15,1 audio DSP graph:
+# build the effective graph, preflight the prerequisites, install, reload.
+#
+#   ./apply.sh          validate + preflight + build + install + reload
+#   ./apply.sh -f       skip the preflight checks (JSON validation still runs)
+#
+# If  user_eq.json  exists next to this script, its contents replace the
+# "user_eq" node's control block (requires jq) - copy user_eq.example.json to
+# user_eq.json and edit. The merged graph is written to ~/.audiograph.json and
+# that file is what gets installed.
+
+set -u

 SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd -P)"
 GRAPH_SRC="$SCRIPT_DIR/graph.json"
+OVERRIDE="$SCRIPT_DIR/user_eq.json"
+MERGED="$HOME/.audiograph.json"
 GRAPH_DST="/usr/share/t2-linux-audio/15_1/graph.json"

-if [ ! -f "$GRAPH_SRC" ]; then
-    echo "Error: $GRAPH_SRC not found!"
-    exit 1
+FORCE=0
+SIMPLE=1
+HOT=0
+for arg in "${@:-}"; do
+    case "$arg" in
+        -f|--force|--no-check) FORCE=1 ;;
+        --no-bake) SIMPLE=0 ;;
+        -b|--bake|--simple) SIMPLE=1 ;;
+        -h|--hot|--soft) HOT=1 ;;
+    esac
+done
+
+have() { command -v "$1" >/dev/null 2>&1; }
+die()  { echo "Error: $*" >&2; exit 1; }
+
+# --- json validation helper -------------------------------------------
+json_ok() {
+    have python3 && { python3 -c 'import json, sys; json.load(open(sys.argv[1]))' "$1" 2>/dev/null && return 0; return 1; }
+    have jq      && { jq . "$1" >/dev/null 2>&1 && return 0; return 1; }
+    return 2  # cannot check
+}
+
+json_ok "$GRAPH_SRC"; rc=$?
+[ "$rc" -eq 1 ] && die "graph.json is not valid JSON"
+[ "$rc" -eq 2 ] && echo "warn: no python3/jq - skipping JSON validation"
+[ "$rc" -eq 0 ] && echo "ok: graph.json is valid JSON"
+
+# --- build the effective graph ------------------------------------------
+MERGED_SRC="$SCRIPT_DIR/graph_merged.json"
+if [ -f "$OVERRIDE" ]; then
+    have jq || die "$OVERRIDE exists but jq is not installed"
+    jq -e . "$OVERRIDE" >/dev/null 2>&1 || die "$OVERRIDE is not valid JSON"
+    jq -e 'any(.["filter.graph"].nodes[]; .name == "user_eq")' "$GRAPH_SRC" >/dev/null \
+        || die "$GRAPH_SRC has no node named user_eq to override"
+    jq --slurpfile ov "$OVERRIDE" \
+       '(.["filter.graph"].nodes[] | select(.name == "user_eq") | .control) = $ov[0]' \
+       "$GRAPH_SRC" > "$MERGED_SRC" || die "jq merge failed"
+    echo "ok: merged user_eq.json -> $MERGED_SRC"
+else
+    cp "$GRAPH_SRC" "$MERGED_SRC"
+    echo "ok: no user_eq.json - graph as-is -> $MERGED_SRC"
 fi

-echo "Copying graph.json to system path..."
-sudo cp "$GRAPH_SRC" "$GRAPH_DST"
+if [ "$SIMPLE" -eq 1 ]; then
+    echo "==> Baking static DSP stages into single-stage FIR files..."
+    python3 "$SCRIPT_DIR/bake-graph.py" "$MERGED_SRC" || die "bake-graph.py failed"
+    GRAPH_SRC="$SCRIPT_DIR/graph_simple.json"
+    echo "==> Installing baked FIR files -> /usr/share/t2-linux-audio/15_1/"
+    sudo cp -f "$SCRIPT_DIR/laptop-configs/apple/mbp15_1/baked-"*.wav "/usr/share/t2-linux-audio/15_1/" 2>/dev/null || true
+else
+    GRAPH_SRC="$MERGED_SRC"
+fi

-echo "Restarting WirePlumber..."
+cp "$GRAPH_SRC" "$MERGED"
+
+json_ok "$MERGED"; rc=$?
+[ "$rc" -eq 1 ] && die "merged graph $MERGED is not valid JSON"
+
+# --- preflight (against the merged graph) ------------------------------
+if [ "$FORCE" -eq 0 ]; then
+    [ -d "$(dirname "$GRAPH_DST")" ] || die \
+        "destination directory $(dirname "$GRAPH_DST") does not exist (is t2-linux-audio-15-1 installed?)"
+
+    # check all convolver wav files exist
+    if have jq; then
+        wav_files=$(jq -r '.. | .filename? | strings' "$MERGED")
+        for wav in $wav_files; do
+            [ -f "$wav" ] || die "FIR WAV file missing: $wav"
+        done
+        echo "ok: FIR .wav files present"
+    fi
+
+    # check plugin URIs resolve
+    if have lv2ls && have jq; then
+        installed_lv2=$(lv2ls)
+        graph_lv2=$(jq -r '.["filter.graph"].nodes[] | select(.type=="lv2") | .plugin' "$MERGED")
+        for uri in $graph_lv2; do
+            echo "$installed_lv2" | grep -Fqx "$uri" || die \
+                "LV2 plugin URI missing: $uri (check lilv-utils/installed plugins)"
+        done
+        echo "ok: all LV2 plugins resolve"
+    else
+        echo "warn: lv2ls not found - cannot verify plugins (install lilv-utils / lilv)"
+    fi
+fi
+
+# --- preserve master volume (only needed for full WirePlumber restart) --
+SAVED_VOL=""
+IS_MUTED=0
+if [ "$HOT" -eq 0 ] && have wpctl; then
+    VOL_OUT="$(wpctl get-volume @DEFAULT_AUDIO_SINK@ 2>/dev/null || true)"
+    if [ -n "$VOL_OUT" ]; then
+        SAVED_VOL="$(echo "$VOL_OUT" | awk '{print $2}')"
+        if echo "$VOL_OUT" | grep -qi "MUTED"; then
+            IS_MUTED=1
+        fi
+    fi
+fi
+
+# --- install ----------------------------------------------------------
+if [ "$SIMPLE" -eq 1 ]; then
+    echo "Installing baked FIR files -> $(dirname "$GRAPH_DST")/"
+    for f in "$SCRIPT_DIR/laptop-configs/apple/mbp15_1/baked-"*.wav "$SCRIPT_DIR/15_1/baked-"*.wav "$SCRIPT_DIR/baked-"*.wav; do
+        if [ -f "$f" ]; then
+            bn="$(basename "$f")"
+            sudo cp "$f" "$(dirname "$GRAPH_DST")/$bn.tmp"
+            sudo mv -f "$(dirname "$GRAPH_DST")/$bn.tmp" "$(dirname "$GRAPH_DST")/$bn"
+        fi
+    done
+fi
+
+echo "Installing $MERGED -> $GRAPH_DST"
+sudo cp "$MERGED" "$GRAPH_DST.tmp"
+sudo mv -f "$GRAPH_DST.tmp" "$GRAPH_DST"
+
+if [ "$HOT" -eq 1 ]; then
+    echo "Hot-reloading WirePlumber graph (zero audio drop)..."
+    if systemctl --user reload wireplumber 2>/dev/null || pkill -HUP -f wireplumber 2>/dev/null; then
+        echo "ok: sent SIGHUP live reload to WirePlumber"
+        sleep 0.4
+    else
+        echo "warn: SIGHUP failed - restarting WirePlumber fallback"
+        systemctl --user restart wireplumber
+        sleep 1.2
+    fi
+
+    # Ensure output is unmuted after live reload
+    if [ -n "$SAVED_VOL" ] && have wpctl; then
+        wpctl set-mute @DEFAULT_AUDIO_SINK@ 0 2>/dev/null || true
+        wpctl set-volume @DEFAULT_AUDIO_SINK@ "$SAVED_VOL" 2>/dev/null || true
+    fi
+    echo "Done - FIR graph reloaded live."
+    exit 0
+fi
+
+# --- full WirePlumber restart -----------------------------------------
+echo "Restarting WirePlumber"
 systemctl --user restart wireplumber
+sleep 1.2

-echo "Done! The new DSP configuration is loaded."
+# --- wait for DSP sink to be active & restore master volume ------------
+for i in {1..6}; do
+    if have wpctl && wpctl status 2>/dev/null | grep -qi "DSP Speakers"; then
+        break
+    fi
+    sleep 0.5
+done
+
+if [ -n "$SAVED_VOL" ] && have wpctl; then
+    # Force unmute on default sink + explicit DSP Speakers sink ID
+    wpctl set-mute @DEFAULT_AUDIO_SINK@ 0 2>/dev/null || true
+
+    DSP_ID="$(wpctl status 2>/dev/null | grep -i "DSP Speakers" | grep -oE '[0-9]+\.' | head -n1 | tr -d '.')"
+    if [ -n "$DSP_ID" ]; then
+        wpctl set-mute "$DSP_ID" 0 2>/dev/null || true
+        wpctl set-volume "$DSP_ID" "$SAVED_VOL" 2>/dev/null || true
+    fi
+    wpctl set-volume @DEFAULT_AUDIO_SINK@ "$SAVED_VOL" 2>/dev/null || true
+
+    if [ "$IS_MUTED" -eq 1 ]; then
+        wpctl set-mute @DEFAULT_AUDIO_SINK@ 1 2>/dev/null || true
+        [ -n "$DSP_ID" ] && wpctl set-mute "$DSP_ID" 1 2>/dev/null || true
+    fi
+    echo "ok: preserved master volume (${SAVED_VOL})"
+fi
+
+# --- confirm --------------------------------------------------------
+if have wpctl && wpctl status 2>/dev/null | grep -qi "DSP Speakers"; then
+    echo "Done - 'MacBook Pro 15,1 DSP Speakers' sink is up."
+else
+    echo "Done - graph installed, WirePlumber reloaded."
+    echo "If no 'DSP Speakers' sink shows: journalctl --user -u wireplumber -b -e"
+fi
--- a/bake-graph.py
+++ b/bake-graph.py
@@ -0,0 +1,519 @@
+#!/usr/bin/env python3
+"""
+bake-graph.py — Single-Stage FIR Convolver & Graph Simplifier for mbp15-1-audio-dsp
+
+Combines all static LTI DSP stages (User EQ + Voicing EQ + Crossover High-Pass Filters)
+directly into composite "baked" FIR impulse response WAV files per driver:
+  - baked-tweeters-44k.wav / baked-tweeters-48k.wav / baked-tweeters-96k.wav
+  - baked-woofers-44k.wav / baked-woofers-48k.wav / baked-woofers-96k.wav
+
+Generates a lean, ultra-low-CPU graph_simple.json PipeWire graph file.
+Runs with pure standard-library Python 3 (math, struct, wave, json, os).
+"""
+
+import os
+import sys
+import math
+import struct
+import wave
+import json
+
+SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
+
+def biquad_peaking(fs, f0, gain_db, q):
+    if gain_db == 0.0 or gain_db == 1.0:
+        return 1.0, 0.0, 0.0, 1.0, 0.0, 0.0
+    A = 10.0 ** (gain_db / 40.0)
+    w0 = 2.0 * math.pi * f0 / fs
+    alpha = math.sin(w0) / (2.0 * max(q, 0.01))
+    b0 = 1.0 + alpha * A
+    b1 = -2.0 * math.cos(w0)
+    b2 = 1.0 - alpha * A
+    a0 = 1.0 + alpha / A
+    a1 = -2.0 * math.cos(w0)
+    a2 = 1.0 - alpha / A
+    return b0/a0, b1/a0, b2/a0, 1.0, a1/a0, a2/a0
+
+def biquad_highpass(fs, f0, q=0.7071):
+    w0 = 2.0 * math.pi * f0 / fs
+    alpha = math.sin(w0) / (2.0 * q)
+    cos_w0 = math.cos(w0)
+    b0 = (1.0 + cos_w0) / 2.0
+    b1 = -(1.0 + cos_w0)
+    b2 = (1.0 + cos_w0) / 2.0
+    a0 = 1.0 + alpha
+    a1 = -2.0 * cos_w0
+    a2 = 1.0 - alpha
+    return b0/a0, b1/a0, b2/a0, 1.0, a1/a0, a2/a0
+
+def biquad_lowpass(fs, f0, q=0.7071):
+    w0 = 2.0 * math.pi * f0 / fs
+    alpha = math.sin(w0) / (2.0 * q)
+    cos_w0 = math.cos(w0)
+    b0 = (1.0 - cos_w0) / 2.0
+    b1 = 1.0 - cos_w0
+    b2 = (1.0 - cos_w0) / 2.0
+    a0 = 1.0 + alpha
+    a1 = -2.0 * cos_w0
+    a2 = 1.0 - alpha
+    return b0/a0, b1/a0, b2/a0, 1.0, a1/a0, a2/a0
+
+def biquad_lowshelf(fs, f0, gain_db, q=0.7071):
+    if gain_db == 0.0:
+        return 1.0, 0.0, 0.0, 1.0, 0.0, 0.0
+    A = 10.0 ** (gain_db / 40.0)
+    w0 = 2.0 * math.pi * f0 / fs
+    alpha = math.sin(w0) / (2.0 * q)
+    cos_w0 = math.cos(w0)
+    beta = math.sqrt(A) / q
+    
+    b0 = A * ((A + 1.0) - (A - 1.0) * cos_w0 + beta * math.sin(w0))
+    b1 = 2.0 * A * ((A - 1.0) - (A + 1.0) * cos_w0)
+    b2 = A * ((A + 1.0) - (A - 1.0) * cos_w0 - beta * math.sin(w0))
+    a0 = (A + 1.0) + (A - 1.0) * cos_w0 + beta * math.sin(w0)
+    a1 = -2.0 * ((A - 1.0) + (A + 1.0) * cos_w0)
+    a2 = (A + 1.0) + (A - 1.0) * cos_w0 - beta * math.sin(w0)
+    return b0/a0, b1/a0, b2/a0, 1.0, a1/a0, a2/a0
+
+def biquad_highshelf(fs, f0, gain_db, q=0.7071):
+    if gain_db == 0.0:
+        return 1.0, 0.0, 0.0, 1.0, 0.0, 0.0
+    A = 10.0 ** (gain_db / 40.0)
+    w0 = 2.0 * math.pi * f0 / fs
+    alpha = math.sin(w0) / (2.0 * q)
+    cos_w0 = math.cos(w0)
+    beta = math.sqrt(A) / q
+    
+    b0 = A * ((A + 1.0) + (A - 1.0) * cos_w0 + beta * math.sin(w0))
+    b1 = -2.0 * A * ((A - 1.0) + (A + 1.0) * cos_w0)
+    b2 = A * ((A + 1.0) + (A - 1.0) * cos_w0 - beta * math.sin(w0))
+    a0 = (A + 1.0) - (A - 1.0) * cos_w0 + beta * math.sin(w0)
+    a1 = 2.0 * ((A - 1.0) - (A + 1.0) * cos_w0)
+    a2 = (A + 1.0) - (A - 1.0) * cos_w0 - beta * math.sin(w0)
+    return b0/a0, b1/a0, b2/a0, 1.0, a1/a0, a2/a0
+
+def apply_biquad_to_samples(b0, b1, b2, a0, a1, a2, samples):
+    out = [0.0] * len(samples)
+    x1 = x2 = y1 = y2 = 0.0
+    for i, x in enumerate(samples):
+        y = b0 * x + b1 * x1 + b2 * x2 - a1 * y1 - a2 * y2
+        x2 = x1
+        x1 = x
+        y2 = y1
+        y1 = y
+        out[i] = y
+    return out
+
+def read_wav_floats(filepath):
+    with open(filepath, 'rb') as f:
+        data = f.read()
+
+    if data[:4] != b'RIFF' or data[8:12] != b'WAVE':
+        raise ValueError(f"Not a valid RIFF WAVE file: {filepath}")
+
+    pos = 12
+    fmt_found = False
+    audio_format = 1
+    nchannels = 1
+    fs = 48000
+    sampwidth = 2
+    raw_bytes = b''
+
+    while pos + 8 <= len(data):
+        chunk_id = data[pos:pos+4]
+        chunk_size = struct.unpack('<I', data[pos+4:pos+8])[0]
+        chunk_data = data[pos+8:pos+8+chunk_size]
+        pos += 8 + chunk_size
+        if chunk_size % 2 == 1:
+            pos += 1
+
+        if chunk_id == b'fmt ':
+            audio_format, nchannels, fs, _, _, bits_per_sample = struct.unpack('<HHIIHH', chunk_data[:16])
+            sampwidth = bits_per_sample // 8
+            fmt_found = True
+        elif chunk_id == b'data':
+            raw_bytes = chunk_data
+
+    if not fmt_found:
+        raise ValueError(f"No fmt chunk found in {filepath}")
+
+    n_samples = len(raw_bytes) // sampwidth
+    if sampwidth == 2:
+        ints = struct.unpack(f"<{n_samples}h", raw_bytes)
+        floats = [i / 32768.0 for i in ints]
+    elif sampwidth == 4:
+        floats = list(struct.unpack(f"<{n_samples}f", raw_bytes))
+    else:
+        raise ValueError(f"Unsupported sample width: {sampwidth}")
+
+    if nchannels > 1:
+        mono_floats = [floats[i] for i in range(0, len(floats), nchannels)]
+        return mono_floats, fs
+    return floats, fs
+
+def write_wav_floats(filepath, samples, fs):
+    data = struct.pack(f"<{len(samples)}f", *samples)
+    riff_header = b'RIFF' + struct.pack('<I', 36 + len(data)) + b'WAVE'
+    fmt_header = b'fmt ' + struct.pack('<I', 16) + struct.pack('<HHIIHH', 3, 1, fs, fs * 4, 4, 32)
+    data_header = b'data' + struct.pack('<I', len(data))
+    
+    os.makedirs(os.path.dirname(os.path.abspath(filepath)), exist_ok=True)
+    with open(filepath, 'wb') as f:
+        f.write(riff_header + fmt_header + data_header + data)
+
+def apply_true_peak_guard(samples, max_allowed_dbfs=-0.5):
+    if not samples:
+        return samples
+    # 4x oversampled true peak estimation (inter-sample peak detection)
+    max_tp = 0.0
+    for i in range(len(samples) - 1):
+        s0 = samples[i]
+        s1 = samples[i+1]
+        max_tp = max(max_tp, abs(s0), abs(s1))
+        for t in [0.25, 0.5, 0.75]:
+            interp = s0 + t * (s1 - s0)
+            max_tp = max(max_tp, abs(interp))
+
+    max_allowed_linear = 10.0 ** (max_allowed_dbfs / 20.0) # -0.5 dBFS = 0.9441
+    if max_tp > max_allowed_linear:
+        scale = max_allowed_linear / max_tp
+        samples = [s * scale for s in samples]
+        print(f"  [True-Peak Guard] ISP Peak: {max_tp:.3f} -> scaled by {scale:.4f} ({max_allowed_dbfs:.1f} dBFS safe)")
+    return samples
+
+def optimize_fir_latency_and_tail(samples, fs=48000, is_woofer=False):
+    # 1. Find absolute peak index
+    peak_idx = 0
+    max_val = 0.0
+    for i, s in enumerate(samples):
+        if abs(s) > max_val:
+            max_val = abs(s)
+            peak_idx = i
+
+    # 5.0 ms pre-peak lead (240 samples @ 48kHz) to eliminate phase artifacts & ringing
+    lead_target = int(0.005 * fs)
+    lead_len = min(lead_target, peak_idx)
+    start_idx = peak_idx - lead_len
+    
+    # Calculate energy of original vs cropped
+    total_energy = sum(s*s for s in samples)
+    cropped = samples[start_idx:]
+    
+    # Apply smooth 64-sample cosine fade-in on the 5ms lead (zero phase click/ripple)
+    fade_in_len = min(64, lead_len)
+    for i in range(fade_in_len):
+        fade = 0.5 * (1.0 - math.cos(math.pi * i / max(fade_in_len, 1)))
+        cropped[i] *= fade
+
+    # 2. Lopsided Tail Extension: 16,384 taps for woofers, 8,192 taps for tweeters
+    target_len = 16384 if is_woofer else 8192
+    if len(cropped) < target_len:
+        tail_pad = target_len - len(cropped)
+        cropped.extend([0.0] * tail_pad)
+    elif len(cropped) > target_len:
+        cropped = cropped[:target_len]
+
+    # Smooth exponential tail fadeout over last 2048 samples
+    fade_len = 2048
+    for i in range(fade_len):
+        idx = len(cropped) - fade_len + i
+        fade = 0.5 * (1.0 + math.cos(math.pi * i / fade_len))
+        cropped[idx] *= fade
+
+    return cropped
+
+import cmath
+
+def apply_pink_noise_target_filter(samples, fs=48000, f_ref=1000.0):
+    """
+    Applies a continuous, exact 1/sqrt(f) (-3.01 dB/octave) Pink Noise target weighting filter
+    to convert raw white-noise sweep measurements to a true equal-energy-per-octave acoustic output.
+    """
+    N = len(samples)
+    # Pure Python Cooley-Tukey FFT
+    def fft(x):
+        n = len(x)
+        if n <= 1:
+            return x
+        even = fft(x[0::2])
+        odd = fft(x[1::2])
+        terms = [cmath.exp(-2j * math.pi * k / n) * odd[k] for k in range(n // 2)]
+        return [even[k] + terms[k] for k in range(n // 2)] + [even[k] - terms[k] for k in range(n // 2)]
+
+    def ifft(x):
+        n = len(x)
+        if n <= 1:
+            return x
+        even = ifft(x[0::2])
+        odd = ifft(x[1::2])
+        terms = [cmath.exp(2j * math.pi * k / n) * odd[k] for k in range(n // 2)]
+        return [even[k] + terms[k] for k in range(n // 2)] + [even[k] - terms[k] for k in range(n // 2)]
+
+    # Pad N to next power of 2
+    pad_len = 1 << (N - 1).bit_length()
+    x_padded = [complex(s, 0.0) for s in samples] + [0j] * (pad_len - N)
+    
+    fft_vals = fft(x_padded)
+    
+    # Apply 1/sqrt(f) weighting
+    max_boost_lin = 10.0 ** (15.0 / 20.0) # +15 dB cap at subsonic
+    for k in range(pad_len):
+        freq = (k * fs) / pad_len
+        if k > pad_len // 2:
+            freq = ((pad_len - k) * fs) / pad_len
+        if freq > 10.0:
+            weight = math.sqrt(f_ref / max(freq, 10.0))
+            weight = min(weight, max_boost_lin)
+        else:
+            weight = 1.0
+        fft_vals[k] *= weight
+        
+    ifft_vals = ifft(fft_vals)
+    pink_samples = [ifft_vals[k].real / pad_len for k in range(N)]
+    return pink_samples
+
+def extract_biquads_from_node(node, fs):
+    biquads = []
+    control = node.get("control", {})
+    if control.get("enabled", 1) == 0:
+        return biquads
+
+    for i in range(16):
+        f_key = f"f_{i}"
+        g_key = f"g_{i}"
+        q_key = f"q_{i}"
+        ft_key = f"ft_{i}"
+        if f_key not in control:
+            break
+        f = control[f_key]
+        g_lin = control.get(g_key, 1.0)
+        q = control.get(q_key, 0.7071)
+        ft = control.get(ft_key, 1)
+
+        if g_lin <= 0.0001:
+            gain_db = -80.0
+        else:
+            gain_db = 20.0 * math.log10(g_lin)
+
+        if abs(gain_db) < 0.001 or ft == 0:
+            continue
+
+        if ft == 1:
+            coeffs = biquad_peaking(fs, f, gain_db, q)
+        elif ft == 3:
+            coeffs = biquad_highshelf(fs, f, gain_db, q)
+        elif ft == 5:
+            coeffs = biquad_lowshelf(fs, f, gain_db, q)
+        else:
+            continue
+
+        biquads.append(coeffs)
+    return biquads
+
+def bake_driver_ir(src_wav, dst_wav, is_woofer=False, driver_gain=1.0, biquads=[]):
+    if not os.path.exists(src_wav):
+        print(f"Warning: {src_wav} not found, skipping.")
+        return False
+    
+    samples, fs = read_wav_floats(src_wav)
+
+    # 1. Convolve all static LTI biquad stages (User EQ + Voicing EQ) directly into driver IR
+    for coeffs in biquads:
+        b0, b1, b2, a0, a1, a2 = coeffs
+        samples = apply_biquad_to_samples(b0, b1, b2, a0, a1, a2, samples)
+
+    # 2. Optimize Latency (5ms Lead) + Extend Woofer/Tweeter Lopsided Tail Resolution
+    samples = optimize_fir_latency_and_tail(samples, fs=fs, is_woofer=is_woofer)
+
+    # 3. True-Peak Inter-Sample Peak (ISP) Guarding (-0.5 dBFS ceiling)
+    samples = apply_true_peak_guard(samples, max_allowed_dbfs=-0.5)
+
+    write_wav_floats(dst_wav, samples, fs)
+    print(f"==> Baked {os.path.basename(dst_wav)} ({fs} Hz, {len(samples)} taps, {len(biquads)} biquads convolved)")
+    return True
+
+def generate_simple_graph_and_bake(profile_dir=None, input_graph_path=None):
+    if not profile_dir:
+        try:
+            import detect_hardware
+            profile_dir, prof = detect_hardware.detect_profile()
+        except Exception:
+            profile_dir = os.path.join(SCRIPT_DIR, "laptop-configs", "apple", "mbp15_1")
+
+    if not profile_dir or not os.path.exists(profile_dir):
+        profile_dir = os.path.join(SCRIPT_DIR, "15_1")
+
+    if input_graph_path and os.path.exists(input_graph_path):
+        graph_path = input_graph_path
+    else:
+        graph_path = os.path.join(profile_dir, "graph.json")
+        if not os.path.exists(graph_path):
+            graph_path = os.path.join(SCRIPT_DIR, "graph.json")
+
+    simple_graph_path = os.path.join(SCRIPT_DIR, "graph_simple.json")
+    
+    if not os.path.exists(graph_path):
+        print(f"Error: {graph_path} not found.")
+        sys.exit(1)
+
+    with open(graph_path, 'r') as f:
+        graph = json.load(f)
+
+    repo_151 = profile_dir
+    sys_dir = "/usr/share/t2-linux-audio/15_1"
+    os.makedirs(repo_151, exist_ok=True)
+
+    nodes = graph.get("filter.graph", {}).get("nodes", [])
+    
+    # 1. Discover all convolver nodes and their input WAV files dynamically from graph.json
+    convolver_tasks = {} # maps raw_basename -> task dict
+
+    for node in nodes:
+        if node.get("label") == "convolver" or "conv" in node.get("name", ""):
+            name = node.get("name", "")
+            config = node.get("config", {})
+            gain = config.get("gain", 1.0)
+            filenames = config.get("filename", [])
+            is_woofer = ("woofer" in name.lower() or "convlw" in name.lower() or "convrw" in name.lower())
+
+            for sys_path in filenames:
+                raw_basename = os.path.basename(sys_path).replace("baked-", "")
+                if not raw_basename in convolver_tasks:
+                    if "woofer" in raw_basename.lower():
+                        is_woofer = True
+                    baked_basename = "baked-" + raw_basename
+                    repo_dst_path = os.path.join(repo_151, baked_basename)
+                    sys_dst_path = os.path.join(sys_dir, baked_basename)
+                    convolver_tasks[raw_basename] = {
+                        "raw_basename": raw_basename,
+                        "baked_basename": baked_basename,
+                        "is_woofer": is_woofer,
+                        "gain": gain,
+                        "repo_dst": repo_dst_path,
+                        "sys_dst": sys_dst_path
+                    }
+
+    # 2. Discover all static biquad EQ nodes (user_eq and equalizer) to convolve into FIR targets
+    biquad_nodes = [node for node in nodes if node.get("name") in ["user_eq", "equalizer"]]
+
+    # 3. Bake FIR files dynamically for all discovered WAV targets from PURE raw measurement source files
+    for raw_basename, task in convolver_tasks.items():
+        src_path = os.path.join(repo_151, raw_basename)
+        if not os.path.exists(src_path):
+            src_path = os.path.join(SCRIPT_DIR, "15_1", raw_basename)
+        if not os.path.exists(src_path):
+            src_path = os.path.join(SCRIPT_DIR, raw_basename)
+        if not os.path.exists(src_path):
+            src_path = os.path.join(sys_dir, raw_basename)
+
+        if not os.path.exists(src_path):
+            print(f"Warning: Raw measurement source {raw_basename} not found in {repo_151} or {sys_dir}.")
+            continue
+
+        # Read src_path to determine sample rate fs for exact biquad coefficient generation
+        _, fs = read_wav_floats(src_path)
+        biquads = []
+        for bnode in biquad_nodes:
+            biquads.extend(extract_biquads_from_node(bnode, fs))
+
+        bake_driver_ir(
+            src_wav=src_path,
+            dst_wav=task["repo_dst"],
+            is_woofer=task["is_woofer"],
+            driver_gain=task["gain"],
+            biquads=biquads
+        )
+
+    # 3. Build graph_simple.json dynamically from graph.json (omitting user_eq, equalizer, whp* nodes, and disabled loudness)
+    graph["node.description"] = "MacBook Pro 15,1 DSP Speakers (Baked FIR Crossovers & Latency Trimming)"
+    new_nodes = []
+
+    loudness_node = next((n for n in nodes if n.get("name") == "loudness"), None)
+    loudness_enabled = loudness_node and loudness_node.get("control", {}).get("enabled", 1) == 1
+
+    for node in nodes:
+        name = node.get("name", "")
+        # Omit user_eq, equalizer (baked into FIRs), whp* crossover nodes, and disabled loudness
+        if name in ["user_eq", "equalizer", "whpL1", "whpL2", "whpR1", "whpR2"]:
+            continue
+        if name == "loudness" and not loudness_enabled:
+            continue
+
+        if node.get("label") == "convolver" or "conv" in name:
+            orig_filenames = node.get("config", {}).get("filename", [])
+            baked_fns = []
+            for p in orig_filenames:
+                rb = os.path.basename(p).replace("baked-", "")
+                if rb in convolver_tasks:
+                    baked_fns.append(convolver_tasks[rb]["sys_dst"])
+                else:
+                    baked_fns.append(os.path.join(sys_dir, "baked-" + rb))
+            node["config"]["filename"] = baked_fns
+
+        new_nodes.append(node)
+
+    # Re-wire links: filter out removed user_eq, equalizer & whp* crossover links
+    links = graph.get("filter.graph", {}).get("links", [])
+    new_links = []
+    for link in links:
+        out_node = link.get("output", "")
+        in_node = link.get("input", "")
+        if ("user_eq" in out_node or "user_eq" in in_node or
+            "equalizer" in out_node or "equalizer" in in_node or
+            "whp" in out_node or "whp" in in_node or
+            (not loudness_enabled and ("loudness" in out_node or "loudness" in in_node))):
+            continue
+        new_links.append(link)
+
+    # Wire virtualbass output
+    if loudness_enabled:
+        new_links.append({"output": "virtualbass:out_l", "input": "loudness:in_l"})
+        new_links.append({"output": "virtualbass:out_r", "input": "loudness:in_r"})
+    else:
+        new_links.append({"output": "virtualbass:out_l", "input": "copyL:In"})
+        new_links.append({"output": "virtualbass:out_r", "input": "copyR:In"})
+
+    # Set graph inputs directly to virtualbass (first active node in simplified processing chain)
+    graph["filter.graph"]["inputs"] = [
+        "virtualbass:in_l",
+        "virtualbass:in_r"
+    ]
+
+    # Remove capture.volumes from filter.graph if present
+    graph["filter.graph"].pop("capture.volumes", None)
+
+    # Consolidated volume tracking inside capture.props if loudness enabled
+    if "capture.props" not in graph:
+        graph["capture.props"] = {}
+
+    if loudness_enabled:
+        graph["capture.props"]["capture.volumes"] = [
+            {
+                "control": "loudness:volume",
+                "min": -65.0,
+                "max": 0.0,
+                "scale": "cubic"
+            }
+        ]
+    else:
+        graph["capture.props"].pop("capture.volumes", None)
+
+    graph["filter.graph"]["nodes"] = new_nodes
+    graph["filter.graph"]["links"] = new_links
+
+    with open(simple_graph_path, 'w') as f:
+        json.dump(graph, f, indent=4)
+
+    print(f"==> Generated {os.path.basename(simple_graph_path)} (simplified single-stage DSP graph)")
+
+def main():
+    print("=================================================================")
+    print("  SINGLE-STAGE FIR CONVOLVER BAKER & GRAPH SIMPLIFIER")
+    print("=================================================================")
+    input_graph = sys.argv[1] if len(sys.argv) > 1 else None
+    generate_simple_graph_and_bake(input_graph_path=input_graph)
+    print("=================================================================")
+    print("Done! Baked FIR files & graph_simple.json created.")
+
+if __name__ == "__main__":
+    main()
--- a/cap.wav
+++ b/cap.wav
--- a/compare-response.py
+++ b/compare-response.py
@@ -0,0 +1,116 @@
+#!/usr/bin/env python3
+"""
+compare-response.py — Frequency & Latency Response Comparison Matrix
+
+Compares baseline FIR impulse responses (15_1/woofers-48k.wav & tweeters-48k.wav)
+against baked composite FIR filters (15_1/baked-woofers-48k.wav & baked-tweeters-48k.wav).
+
+Prints magnitude (dB) and latency (ms) across key acoustic frequencies.
+Runs with pure standard-library Python 3.
+"""
+
+import os
+import sys
+import math
+import struct
+import json
+
+SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
+
+def read_wav_floats(filepath):
+    with open(filepath, 'rb') as f:
+        content = f.read()
+
+    if not content.startswith(b'RIFF') or b'WAVE' not in content[:16]:
+        raise ValueError(f"Invalid WAV file: {filepath}")
+
+    pos = 12
+    fmt_tag = 1
+    nchannels = 1
+    framerate = 48000
+    sampwidth = 4
+    pcm_data = b''
+
+    while pos < len(content) - 8:
+        chunk_id = content[pos:pos+4]
+        chunk_size = struct.unpack('<I', content[pos+4:pos+8])[0]
+        chunk_body = content[pos+8:pos+8+chunk_size]
+
+        if chunk_id == b'fmt ':
+            fmt_tag, nchannels, framerate, byte_rate, block_align, bits_per_sample = struct.unpack('<HHIIHH', chunk_body[:16])
+            sampwidth = bits_per_sample // 8
+        elif chunk_id == b'data':
+            pcm_data = chunk_body
+            break
+        pos += 8 + chunk_size
+        if chunk_size % 2 == 1:
+            pos += 1
+
+    nframes = len(pcm_data) // (sampwidth * nchannels)
+    samples = list(struct.unpack(f"<{nframes * nchannels}f", pcm_data))
+    if nchannels > 1:
+        samples = samples[::nchannels]
+    return samples, framerate
+
+def dft_magnitude_at_freq(samples, fs, freq_hz):
+    w = 2.0 * math.pi * freq_hz / fs
+    re = sum(s * math.cos(w * n) for n, s in enumerate(samples))
+    im = sum(-s * math.sin(w * n) for n, s in enumerate(samples))
+    mag = math.sqrt(re * re + im * im)
+    db = 20.0 * math.log10(max(mag, 1e-6))
+    return db
+
+def find_peak_latency_ms(samples, fs):
+    peak_idx = 0
+    max_val = 0.0
+    for i, s in enumerate(samples):
+        if abs(s) > max_val:
+            max_val = abs(s)
+            peak_idx = i
+    return (peak_idx / fs) * 1000.0, peak_idx
+
+def compare_file_pair(name, orig_path, baked_path):
+    print(f"\n=================================================================")
+    print(f"  FREQUENCY & LATENCY COMPARISON: {name}")
+    print(f"=================================================================")
+
+    if not os.path.exists(orig_path) or not os.path.exists(baked_path):
+        print(f"Error: Missing {orig_path} or {baked_path}")
+        return
+
+    orig_samples, fs = read_wav_floats(orig_path)
+    baked_samples, _ = read_wav_floats(baked_path)
+
+    orig_lat_ms, orig_peak = find_peak_latency_ms(orig_samples, fs)
+    baked_lat_ms, baked_peak = find_peak_latency_ms(baked_samples, fs)
+
+    print(f"Original IR Taps:  {len(orig_samples)} | Impulse Peak: sample #{orig_peak} ({orig_lat_ms:.2f} ms delay)")
+    print(f"Baked IR Taps:     {len(baked_samples)} | Impulse Peak: sample #{baked_peak} ({baked_lat_ms:.2f} ms delay)")
+    print(f"Latency Reduction: -{orig_lat_ms - baked_lat_ms:.2f} ms ({((orig_lat_ms - baked_lat_ms)/max(orig_lat_ms, 0.001))*100:.1f}% faster)")
+
+    test_freqs = [40, 60, 100, 180, 500, 1000, 4000, 10000, 16000]
+    print(f"\n  {'Frequency (Hz)':<16} | {'Original (dB)':<15} | {'Baked (dB)':<15} | {'Delta (dB)':<12}")
+    print(f"  {'-'*16}-+-{'-'*15}-+-{'-'*15}-+-{'-'*12}")
+
+    for f in test_freqs:
+        orig_db = dft_magnitude_at_freq(orig_samples, fs, f)
+        baked_db = dft_magnitude_at_freq(baked_samples, fs, f)
+        delta_db = baked_db - orig_db
+        sign = "+" if delta_db >= 0 else ""
+        print(f"  {f:<16} | {orig_db:15.2f} | {baked_db:15.2f} | {sign}{delta_db:11.2f} dB")
+
+def main():
+    print("=================================================================")
+    print("  mbp15-1-audio-dsp FIR RESPONSE COMPARISON ANALYZER")
+    print("=================================================================")
+
+    tweeter_orig = os.path.join(SCRIPT_DIR, "15_1", "tweeters-48k.wav")
+    tweeter_baked = os.path.join(SCRIPT_DIR, "15_1", "baked-tweeters-48k.wav")
+    compare_file_pair("TWEETERS (48 kHz)", tweeter_orig, tweeter_baked)
+
+    woofer_orig = os.path.join(SCRIPT_DIR, "15_1", "woofers-48k.wav")
+    woofer_baked = os.path.join(SCRIPT_DIR, "15_1", "baked-woofers-48k.wav")
+    compare_file_pair("WOOFERS (48 kHz)", woofer_orig, woofer_baked)
+
+if __name__ == "__main__":
+    main()
--- a/detect_hardware.py
+++ b/detect_hardware.py
@@ -0,0 +1,150 @@
+#!/usr/bin/env python3
+import os
+import sys
+import json
+import glob
+
+SCRIPT_DIR = os.path.dirname(os.path.realpath(__file__))
+CONFIGS_DIR = os.path.join(SCRIPT_DIR, "laptop-configs")
+
+def print_help():
+    print("""=================================================================
+  LAPTOP AUDIO DSP HARDWARE DETECTION TOOL
+=================================================================
+Usage:
+  ./detect_hardware.py [options]
+
+Options:
+  -h, --help              Show this help message
+  -l, --list-configs      List all available laptop hardware profiles
+  -m, --model <name>      Manually specify model/profile ID (e.g., apple_mbp15_1)
+  --manual <name>         Same as --model
+  -p, --profile <path>    Path to custom profile directory
+  --json                  Output detection details in JSON format
+  --quiet                 Suppress warning messages on fallback
+
+Examples:
+  ./detect_hardware.py
+  ./detect_hardware.py --list-configs
+  ./detect_hardware.py --model apple_mbp15_1
+  ./detect_hardware.py --json
+=================================================================
+""")
+
+def read_dmi_file(filename):
+    path = os.path.join("/sys/class/dmi/id", filename)
+    if os.path.exists(path):
+        try:
+            with open(path, 'r') as f:
+                return f.read().strip()
+        except Exception:
+            pass
+    return ""
+
+def list_all_profiles():
+    profile_files = glob.glob(os.path.join(CONFIGS_DIR, "**", "profile.json"), recursive=True)
+    profiles = []
+    for prof_path in sorted(profile_files):
+        try:
+            with open(prof_path, 'r') as f:
+                prof = json.load(f)
+                prof["_path"] = os.path.dirname(prof_path)
+                profiles.append(prof)
+        except Exception:
+            continue
+    return profiles
+
+def print_available_configs():
+    profiles = list_all_profiles()
+    print("=================================================================")
+    print("  AVAILABLE LAPTOP AUDIO DSP CONFIGURATIONS")
+    print("=================================================================")
+    print(f" {'ID':<18} | {'Name':<32} | {'Vendor':<12}")
+    print("-------------------+----------------------------------+----------")
+    for prof in profiles:
+        pid = prof.get("id", os.path.basename(prof["_path"]))
+        name = prof.get("name", "Unknown Laptop")
+        vendor = prof.get("vendor", "Unknown")
+        print(f" {pid:<18} | {name:<32} | {vendor:<12}")
+    print("=================================================================")
+
+def detect_profile(manual_target=None):
+    profile_files = glob.glob(os.path.join(CONFIGS_DIR, "**", "profile.json"), recursive=True)
+    
+    # 1. Manual override check (--model, --manual, --profile)
+    if manual_target:
+        for prof_path in profile_files:
+            try:
+                with open(prof_path, 'r') as f:
+                    prof = json.load(f)
+                pid = prof.get("id", os.path.basename(os.path.dirname(prof_path)))
+                pdir = os.path.dirname(prof_path)
+                if manual_target.lower() in [pid.lower(), pdir.lower(), os.path.basename(pdir).lower()]:
+                    return pdir, prof, False
+            except Exception:
+                continue
+
+    # 2. DMI Hardware Matching
+    vendor = read_dmi_file("sys_vendor")
+    product = read_dmi_file("product_name")
+
+    if vendor or product:
+        for prof_path in profile_files:
+            try:
+                with open(prof_path, 'r') as f:
+                    prof = json.load(f)
+                
+                dmi_matches = prof.get("dmi_matches", [])
+                prof_vendor = prof.get("vendor", "")
+
+                if (not prof_vendor or prof_vendor.lower() in vendor.lower() or vendor.lower() in prof_vendor.lower()):
+                    for match in dmi_matches:
+                        if match.lower() in product.lower():
+                            return os.path.dirname(prof_path), prof, False
+            except Exception:
+                continue
+
+    # 3. Fallback to default MacBookPro15,1 profile with warning
+    fallback_path = os.path.join(CONFIGS_DIR, "apple", "mbp15_1")
+    fallback_json = os.path.join(fallback_path, "profile.json")
+    if os.path.exists(fallback_json):
+        with open(fallback_json, 'r') as f:
+            return fallback_path, json.load(f), True
+            
+    return None, None, True
+
+def main():
+    args = sys.argv[1:]
+
+    if any(arg in args for arg in ["-h", "--help", "help"]):
+        print_help()
+        sys.exit(0)
+    
+    if any(arg in args for arg in ["--list", "--list-configs", "-l", "list"]):
+        print_available_configs()
+        sys.exit(0)
+
+    manual_target = None
+    for i, arg in enumerate(args):
+        if arg in ["--profile", "-p", "--model", "-m", "--manual"] and i + 1 < len(args):
+            manual_target = args[i+1]
+
+    path, prof, is_fallback = detect_profile(manual_target=manual_target)
+    
+    if is_fallback and "--quiet" not in args:
+        vendor = read_dmi_file("sys_vendor") or "Unknown Vendor"
+        product = read_dmi_file("product_name") or "Unknown Model"
+        print(f"Warning: Hardware '{vendor} / {product}' not found in laptop-configs/.", file=sys.stderr)
+        print("Falling back to default 'apple_mbp15_1' profile.", file=sys.stderr)
+        print("Use './detect_hardware.py --list-configs' to view all available profiles.", file=sys.stderr)
+
+    if "--json" in args:
+        print(json.dumps({"path": path, "profile": prof, "is_fallback": is_fallback}, indent=2))
+    else:
+        if path:
+            print(path)
+        else:
+            sys.exit(1)
+
+if __name__ == "__main__":
+    main()
--- a/eq.py
+++ b/eq.py
@@ -0,0 +1,248 @@
+#!/usr/bin/env python3
+"""
+eq.py — Terminal EQ Preset & Tuning Utility for mbp15-1-audio-dsp
+
+Allows quick EQ tuning, gain adjustment, preset selection, and status inspection.
+Automatically applies changes to user_eq.json and hot-reloads into PipeWire via ./apply.sh --bake.
+"""
+
+import sys
+import os
+import json
+import subprocess
+
+SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
+USER_EQ_PATH = os.path.join(SCRIPT_DIR, "user_eq.json")
+
+PRESETS = {
+    "flat": {
+        "g_out": 1.5,
+        "f_0": 70.0, "g_0": 1.0, "q_0": 0.7071, "ft_0": 5,
+        "f_1": 110.0, "g_1": 1.0, "q_1": 1.0, "ft_1": 1,
+        "f_2": 315.0, "g_2": 1.0, "q_2": 1.0, "ft_2": 1,
+        "f_3": 1000.0, "g_3": 1.0, "q_3": 1.0, "ft_3": 1,
+        "f_4": 2500.0, "g_4": 1.0, "q_4": 1.0, "ft_4": 1,
+        "f_5": 6000.0, "g_5": 1.0, "q_5": 1.0, "ft_5": 1,
+        "f_6": 10000.0, "g_6": 1.0, "q_6": 0.7071, "ft_6": 3,
+        "f_7": 16000.0, "g_7": 1.0, "q_7": 0.7071, "ft_7": 3,
+        "enabled": 1
+    },
+    "bass-boost": {
+        "g_out": 1.8,
+        "f_0": 70.0, "g_0": 1.35, "q_0": 0.7071, "ft_0": 5,  # +2.6 dB Low Shelf
+        "f_1": 110.0, "g_1": 1.2, "q_1": 1.0, "ft_1": 1,    # +1.6 dB @ 110Hz
+        "f_2": 315.0, "g_2": 1.0, "q_2": 1.0, "ft_2": 1,
+        "f_3": 1000.0, "g_3": 1.0, "q_3": 1.0, "ft_3": 1,
+        "f_4": 2500.0, "g_4": 1.0, "q_4": 1.0, "ft_4": 1,
+        "f_5": 6000.0, "g_5": 1.0, "q_5": 1.0, "ft_5": 1,
+        "f_6": 10000.0, "g_6": 1.0, "q_6": 0.7071, "ft_6": 3,
+        "f_7": 16000.0, "g_7": 1.0, "q_7": 0.7071, "ft_7": 3,
+        "enabled": 1
+    },
+    "vocal": {
+        "g_out": 1.6,
+        "f_0": 70.0, "g_0": 0.9, "q_0": 0.7071, "ft_0": 5,   # Slightly reduced sub bass
+        "f_1": 110.0, "g_1": 1.0, "q_1": 1.0, "ft_1": 1,
+        "f_2": 315.0, "g_2": 1.0, "q_2": 1.0, "ft_2": 1,
+        "f_3": 1000.0, "g_3": 1.25, "q_3": 1.0, "ft_3": 1,  # +1.9 dB @ 1kHz Vocal clarity
+        "f_4": 2500.0, "g_4": 1.2, "q_4": 1.0, "ft_4": 1,   # +1.6 dB Presence
+        "f_5": 6000.0, "g_5": 1.1, "q_5": 1.0, "ft_5": 1,
+        "f_6": 10000.0, "g_6": 1.0, "q_6": 0.7071, "ft_6": 3,
+        "f_7": 16000.0, "g_7": 1.0, "q_7": 0.7071, "ft_7": 3,
+        "enabled": 1
+    },
+    "warm": {
+        "g_out": 1.7,
+        "f_0": 70.0, "g_0": 1.25, "q_0": 0.7071, "ft_0": 5,  # +1.9 dB Low Shelf
+        "f_1": 110.0, "g_1": 1.15, "q_1": 1.0, "ft_1": 1,
+        "f_2": 315.0, "g_2": 1.05, "q_2": 1.0, "ft_2": 1,
+        "f_3": 1000.0, "g_3": 1.0, "q_3": 1.0, "ft_3": 1,
+        "f_4": 2500.0, "g_4": 1.0, "q_4": 1.0, "ft_4": 1,
+        "f_5": 6000.0, "g_5": 0.9, "q_5": 1.0, "ft_5": 1,   # Softened high end
+        "f_6": 10000.0, "g_6": 0.85, "q_6": 0.7071, "ft_6": 3,
+        "f_7": 16000.0, "g_7": 0.8, "q_7": 0.7071, "ft_7": 3,
+        "enabled": 1
+    },
+    "treble-boost": {
+        "g_out": 1.6,
+        "f_0": 70.0, "g_0": 1.0, "q_0": 0.7071, "ft_0": 5,
+        "f_1": 110.0, "g_1": 1.0, "q_1": 1.0, "ft_1": 1,
+        "f_2": 315.0, "g_2": 1.0, "q_2": 1.0, "ft_2": 1,
+        "f_3": 1000.0, "g_3": 1.0, "q_3": 1.0, "ft_3": 1,
+        "f_4": 2500.0, "g_4": 1.15, "q_4": 1.0, "ft_4": 1,
+        "f_5": 6000.0, "g_5": 1.25, "q_5": 1.0, "ft_5": 1,
+        "f_6": 10000.0, "g_6": 1.3, "q_6": 0.7071, "ft_6": 3, # High Shelf Boost
+        "f_7": 16000.0, "g_7": 1.3, "q_7": 0.7071, "ft_7": 3,
+        "enabled": 1
+    }
+}
+
+def load_user_eq():
+    if os.path.exists(USER_EQ_PATH):
+        try:
+            with open(USER_EQ_PATH, 'r') as f:
+                return json.load(f)
+        except Exception:
+            pass
+    return dict(PRESETS["flat"])
+
+def format_user_eq_json(eq_data):
+    enabled = eq_data.get("enabled", 1)
+    mode = eq_data.get("mode", 0)
+    g_in = eq_data.get("g_in", 1.0)
+    g_out = eq_data.get("g_out", 1.0)
+
+    lines = [
+        "{",
+        f'    "enabled": {enabled}, "mode": {mode}, "g_in": {g_in:.1f}, "g_out": {g_out:.2f},'
+    ]
+
+    for i in range(8):
+        ft = eq_data.get(f"ft_{i}", 1)
+        freq = eq_data.get(f"f_{i}", 1000.0)
+        gain = eq_data.get(f"g_{i}", 1.0)
+        q = eq_data.get(f"q_{i}", 1.0)
+        
+        freq_str = f"{freq:.1f}"
+        band_line = f'    "ft_{i}": {ft}, "f_{i}": {freq_str:<7}, "g_{i}": {gain:<4.2f}, "q_{i}": {q:.1f}'
+        if i == 0 or i == 7:
+            s_val = eq_data.get(f"s_{i}", 0)
+            band_line += f', "s_{i}": {s_val}'
+        if i < 7:
+            band_line += ","
+        lines.append(band_line)
+
+    lines.append("}")
+    return "\n".join(lines) + "\n"
+
+def save_and_apply(eq_data):
+    formatted = format_user_eq_json(eq_data)
+    with open(USER_EQ_PATH, 'w') as f:
+        f.write(formatted)
+    print(f"Saved {USER_EQ_PATH}")
+    print("Baking FIR filters & applying to PipeWire...")
+    subprocess.run([os.path.join(SCRIPT_DIR, "apply.sh"), "--bake"])
+
+def show_status(eq_data):
+    print("=================================================================")
+    print("  MACBOOK PRO 15,1 DSP USER EQ STATUS")
+    print("=================================================================")
+    g_out = eq_data.get("g_out", 1.0)
+    enabled = "ENABLED" if eq_data.get("enabled", 1) == 1 else "DISABLED"
+    print(f"Master Output Gain: {g_out:.2f}x ({20.0*math.log10(max(g_out, 0.001)):+.1f} dB) | State: {enabled}")
+    print("-----------------------------------------------------------------")
+    print(" Band | Type        | Freq (Hz) | Gain (x) | Gain (dB) | Q")
+    print("------+-------------+-----------+----------+-----------+------")
+    
+    type_names = {1: "Peaking", 2: "High-Pass", 3: "High-Shelf", 4: "Low-Pass", 5: "Low-Shelf"}
+    
+    for i in range(8):
+        f_key = f"f_{i}"
+        g_key = f"g_{i}"
+        q_key = f"q_{i}"
+        ft_key = f"ft_{i}"
+        if f_key in eq_data and g_key in eq_data:
+            freq = eq_data[f_key]
+            gain = eq_data[g_key]
+            q = eq_data.get(q_key, 1.0)
+            ft = eq_data.get(ft_key, 1)
+            gain_db = 20.0 * math.log10(max(gain, 0.001))
+            typeName = type_names.get(ft, "Peaking")
+            print(f"  {i:<3} | {typeName:<11} | {freq:<9.1f} | {gain:<8.2f} | {gain_db:<+9.1f} | {q:.2f}")
+    print("=================================================================")
+
+import math
+
+def print_help():
+    print("""
+Usage: ./eq.py [command] [args]
+
+Commands:
+  status / show         Display current EQ settings and gains
+  preset <name>         Apply preset: flat, bass-boost, vocal, warm, treble-boost
+  bass <+dB / -dB>      Adjust bass shelf gain (e.g., ./eq.py bass +2.0)
+  treble <+dB / -dB>    Adjust treble shelf gain (e.g., ./eq.py treble +1.5)
+  gain <multiplier>     Set master output gain multiplier (e.g., ./eq.py gain 2.0)
+  enable / disable      Enable or disable user EQ
+
+Examples:
+  ./eq.py preset bass-boost
+  ./eq.py bass +3
+  ./eq.py status
+""")
+
+def main():
+    args = sys.argv[1:]
+    if not args or args[0] in ["-h", "--help", "help"]:
+        print_help()
+        sys.exit(0)
+
+    cmd = args[0].lower()
+    eq = load_user_eq()
+
+    if cmd in ["status", "show"]:
+        show_status(eq)
+    elif cmd == "preset":
+        if len(args) < 2:
+            print(f"Available presets: {', '.join(PRESETS.keys())}")
+            sys.exit(1)
+        name = args[1].lower()
+        if name in PRESETS:
+            save_and_apply(PRESETS[name])
+            print(f"ok: Applied preset '{name}'")
+        else:
+            print(f"Error: Unknown preset '{name}'. Choose from: {', '.join(PRESETS.keys())}")
+            sys.exit(1)
+    elif cmd == "bass":
+        if len(args) < 2:
+            print("Usage: ./eq.py bass <+dB or -dB>  (e.g., ./eq.py bass +2)")
+            sys.exit(1)
+        val_db = float(args[1].replace("+", ""))
+        gain_mult = 10.0 ** (val_db / 20.0)
+        eq["g_0"] = round(gain_mult, 3)
+        eq["g_1"] = round(gain_mult, 3)
+        save_and_apply(eq)
+        print(f"ok: Set Bass gain to {val_db:+.1f} dB ({gain_mult:.3f}x)")
+    elif cmd == "treble":
+        if len(args) < 2:
+            print("Usage: ./eq.py treble <+dB or -dB>  (e.g., ./eq.py treble +1.5)")
+            sys.exit(1)
+        val_db = float(args[1].replace("+", ""))
+        gain_mult = 10.0 ** (val_db / 20.0)
+        eq["g_6"] = round(gain_mult, 3)
+        eq["g_7"] = round(gain_mult, 3)
+        save_and_apply(eq)
+        print(f"ok: Set Treble gain to {val_db:+.1f} dB ({gain_mult:.3f}x)")
+    elif cmd == "gain":
+        if len(args) < 2:
+            print("Usage: ./eq.py gain <+dB / -dB or multiplier>  (e.g., ./eq.py gain -20 or ./eq.py gain 1.5)")
+            sys.exit(1)
+        raw_val = args[1].lower().replace("x", "").replace("db", "")
+        val = float(raw_val)
+        if val <= 0 and not raw_val.startswith("+"):
+            # Negative number passed (e.g. -20 or -100) -> Treat as dB attenuation
+            gain_mult = 10.0 ** (val / 20.0)
+            eq["g_out"] = round(gain_mult, 5)
+            save_and_apply(eq)
+            print(f"ok: Set Master Output Gain to {val:+.1f} dB ({gain_mult:.5f}x multiplier)")
+        else:
+            # Positive linear multiplier or positive dB
+            if "+" in raw_val:
+                gain_mult = 10.0 ** (val / 20.0)
+                eq["g_out"] = round(gain_mult, 3)
+                print(f"ok: Set Master Output Gain to {val:+.1f} dB ({gain_mult:.3f}x multiplier)")
+            else:
+                eq["g_out"] = round(val, 3)
+                print(f"ok: Set Master Output Gain to {eq['g_out']:.2f}x multiplier")
+            save_and_apply(eq)
+    elif cmd in ["enable", "disable"]:
+        eq["enabled"] = 1 if cmd == "enable" else 0
+        save_and_apply(eq)
+        print(f"ok: User EQ {cmd}d")
+    else:
+        print(f"Error: Unknown command '{cmd}'")
+        print_help()
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()
--- a/graph.json
+++ b/graph.json
@@ -1,33 +1,22 @@
 {
-    "node.description": "MacBook Pro 15,1 DSP Speakers",
-    "media.name": "MacBook Pro 15,1 DSP Speakers",
+    "node.description": "MacBook Pro 15,1 Audio DSP",
+    "media.name": "MacBook Pro 15,1 Audio DSP",
    "filter.graph": {
        "nodes": [
            {
                "type": "lv2",
                "plugin": "http://lsp-plug.in/plugins/lv2/para_equalizer_x16_stereo",
-                "name": "equalizer",
+                "name": "user_eq",
                "control": {
-                    "enabled": 1,
-                    "mode": 0,
-                    "g_in": 0.5,
-                    "g_out": 1.0,
-                    "ft_0": 2, "f_0": 10.0, "g_0": 1.0, "q_0": 1.41, "s_0": 3, "xm_0": 0, "fm_0": 0,
-                    "ft_1": 1, "f_1": 31.5, "g_1": 1.82, "q_1": 1.41, "s_1": 0, "xm_1": 0, "fm_1": 0,
-                    "ft_2": 1, "f_2": 50.0, "g_2": 2.48, "q_2": 1.41, "s_2": 0, "xm_2": 0, "fm_2": 0,
-                    "ft_3": 1, "f_3": 80.0, "g_3": 3.20, "q_3": 1.41, "s_3": 0, "xm_3": 0, "fm_3": 0,
-                    "ft_4": 1, "f_4": 125.0, "g_4": 2.27, "q_4": 1.41, "s_4": 0, "xm_4": 0, "fm_4": 0,
-                    "ft_5": 1, "f_5": 200.0, "g_5": 1.67, "q_5": 1.41, "s_5": 0, "xm_5": 0, "fm_5": 0,
-                    "ft_6": 1, "f_6": 315.0, "g_6": 1.35, "q_6": 1.41, "s_6": 0, "xm_6": 0, "fm_6": 0,
-                    "ft_7": 1, "f_7": 500.0, "g_7": 1.19, "q_7": 1.41, "s_7": 0, "xm_7": 0, "fm_7": 0,
-                    "ft_8": 1, "f_8": 800.0, "g_8": 1.09, "q_8": 1.41, "s_8": 0, "xm_8": 0, "fm_8": 0,
-                    "ft_9": 1, "f_9": 1250.0, "g_9": 0.85, "q_9": 1.41, "s_9": 0, "xm_9": 0, "fm_9": 0,
-                    "ft_10": 1, "f_10": 2000.0, "g_10": 0.8, "q_10": 1.41, "s_10": 0, "xm_10": 0, "fm_10": 0,
-                    "ft_11": 1, "f_11": 3150.0, "g_11": 0.8, "q_11": 1.41, "s_11": 0, "xm_11": 0, "fm_11": 0,
-                    "ft_12": 1, "f_12": 5000.0, "g_12": 0.8, "q_12": 1.41, "s_12": 0, "xm_12": 0, "fm_12": 0,
-                    "ft_13": 1, "f_13": 8000.0, "g_13": 0.8, "q_13": 1.41, "s_13": 0, "xm_13": 0, "fm_13": 0,
-                    "ft_14": 1, "f_14": 12500.0, "g_14": 0.82, "q_14": 1.41, "s_14": 0, "xm_14": 0, "fm_14": 0,
-                    "ft_15": 1, "f_15": 20000.0, "g_15": 0.97, "q_15": 1.41, "s_15": 0, "xm_15": 0, "fm_15": 0
+                    "enabled": 1, "mode": 0, "g_in": 1.0, "g_out": 1.5,
+                    "ft_0": 5, "f_0": 70.0,   "g_0": 1.00, "q_0": 0.70, "s_0": 0,
+                    "ft_1": 1, "f_1": 110.0,  "g_1": 1.00, "q_1": 1.00,
+                    "ft_2": 1, "f_2": 315.0,  "g_2": 1.00, "q_2": 1.00,
+                    "ft_3": 1, "f_3": 600.0,  "g_3": 1.00, "q_3": 1.00,
+                    "ft_4": 1, "f_4": 1000.0, "g_4": 1.00, "q_4": 1.00,
+                    "ft_5": 1, "f_5": 2500.0, "g_5": 1.00, "q_5": 1.00,
+                    "ft_6": 1, "f_6": 6000.0, "g_6": 1.00, "q_6": 1.00,
+                    "ft_7": 3, "f_7": 12000.0,"g_7": 1.00, "q_7": 0.70, "s_7": 0
                }
            },
            {
@@ -35,74 +24,39 @@
                "plugin": "https://chadmed.au/bankstown",
                "name": "virtualbass",
                "control": {
-                    "bypass": 0,
-                    "amt": 1.0,
+                    "amt": 1.4,
+                    "floor": 40.0,
+                    "ceil": 120.0,
+                    "final_hp": 55.0,
                    "sat_second": 1.0,
                    "sat_third": 1.0,
-                    "blend": 1.0,
-                    "ceil": 150.0,
-                    "floor": 60.0
+                    "blend": 0.30
                }
            },
            {
                "type": "lv2",
-                "plugin": "http://lsp-plug.in/plugins/lv2/mb_compressor_stereo",
-                "name": "multiband_compressor",
+                "plugin": "http://lsp-plug.in/plugins/lv2/para_equalizer_x16_stereo",
+                "name": "equalizer",
                "control": {
-                    "enabled": 1,
-                    "mode": 1,
-                    "g_in": 1.5,
-                    "g_out": 1.0,
-                    "g_dry": 0.0001,
-                    "g_wet": 1.0,
-                    "cbe_1": 1, "sf_1": 60.0,
-                    "cbe_2": 1, "sf_2": 80.0,
-                    "cbe_3": 1, "sf_3": 100.0,
-                    "cbe_4": 1, "sf_4": 130.0,
-                    "cbe_5": 1, "sf_5": 160.0,
-                    "cbe_6": 1, "sf_6": 200.0,
-                    "cbe_7": 1, "sf_7": 500.0,
-                    "cbe_8": 1, "sf_8": 1000.0,
-                    "ce_0": 1, "at_0": 0.5,  "rt_0": 120.0, "cr_0": 50.0, "kn_0": 0.0, "al_0": 0.093, "mk_0": 0.5, "bth_0": 1.0, "bsa_0": 1.0, "scm_0": 0,
-                    "ce_1": 1, "at_1": 0.6,  "rt_1": 120.0, "cr_1": 50.0, "kn_1": 0.02, "al_1": 0.078, "mk_1": 1.5, "bth_1": 1.0, "bsa_1": 1.0, "scm_1": 0,
-                    "ce_2": 1, "at_2": 0.7,  "rt_2": 130.0, "cr_2": 30.0, "kn_2": 0.5, "al_2": 0.095, "mk_2": 1.7, "bth_2": 1.0, "bsa_2": 1.0, "scm_2": 0,
-                    "ce_3": 1, "at_3": 0.8,  "rt_3": 150.0, "cr_3": 20.0, "kn_3": 0.15, "al_3": 0.120, "mk_3": 2.0, "bth_3": 1.0, "bsa_3": 1.0, "scm_3": 0,
-                    "ce_4": 1, "at_4": 0.9,  "rt_4": 150.0, "cr_4": 18.0, "kn_4": 0.24, "al_4": 0.130, "mk_4": 2.0, "bth_4": 1.0, "bsa_4": 1.0, "scm_4": 0,
-                    "ce_5": 1, "at_5": 1.0,  "rt_5": 150.0, "cr_5": 16.0, "kn_5": 0.28, "al_5": 0.140, "mk_5": 2.0, "bth_5": 1.0, "bsa_5": 1.0, "scm_5": 0,
-                    "ce_6": 1, "at_6": 1.0, "rt_6": 150.0, "cr_6": 15.0, "kn_6": 0.30, "al_6": 0.159, "mk_6": 2.0, "bth_6": 1.0, "bsa_6": 1.0, "scm_6": 0,
-                    "ce_7": 1, "at_7": 1.4,  "rt_7": 150.0, "cr_7": 5.0,  "kn_7": 0.40, "al_7": 0.284, "mk_7": 1.3, "bth_7": 1.0, "bsa_7": 1.0, "scm_7": 0,
-                    "ce_8": 1, "at_8": 2.0,  "rt_8": 150.0, "cr_8": 5.0,  "kn_8": 0.40, "al_8": 0.284, "mk_8": 1.3, "bth_8": 1.0, "bsa_8": 1.0, "scm_8": 0
-
+                    "enabled": 1, "mode": 0, "g_in": 1.0, "g_out": 1.0,
+                    "ft_0": 5, "f_0": 40.0,   "g_0": 2.83, "q_0": 0.70,
+                    "ft_1": 1, "f_1": 80.0,   "g_1": 2.00, "q_1": 1.00,
+                    "ft_2": 1, "f_2": 160.0,  "g_2": 1.41, "q_2": 1.00,
+                    "ft_3": 1, "f_3": 320.0,  "g_3": 1.00, "q_3": 1.00,
+                    "ft_4": 1, "f_4": 640.0,  "g_4": 0.71, "q_4": 1.00,
+                    "ft_5": 1, "f_5": 1280.0, "g_5": 0.50, "q_5": 1.00,
+                    "ft_6": 1, "f_6": 2560.0, "g_6": 0.35, "q_6": 1.00,
+                    "ft_7": 3, "f_7": 12000.0,"g_7": 0.24, "q_7": 0.70
                }
            },
            {
                "type": "lv2",
-                "name": "limiter",
-                "plugin": "http://plugin.org.uk/swh-plugins/fastLookaheadLimiter",
-                "control": {
-                    "ingain": 0,
-                    "limit": -1,
-                    "release": 0.35
-                }
-            },
-            {
-                "type": "lv2",
-                "plugin": "http://lsp-plug.in/plugins/lv2/loud_comp_mono",
-                "name": "ell",
+                "plugin": "http://lsp-plug.in/plugins/lv2/loud_comp_stereo",
+                "name": "loudness",
                "control": {
                    "enabled": 1,
                    "input": 1.0,
-                    "fft": 4
-                }
-            },
-            {
-                "type": "lv2",
-                "plugin": "http://lsp-plug.in/plugins/lv2/loud_comp_mono",
-                "name": "elr",
-                "control": {
-                    "enabled": 1,
-                    "input": 1.0,
-                    "fft": 4
+                    "fft": 1
                }
            },
            {
@@ -126,7 +80,7 @@
                        "/usr/share/t2-linux-audio/15_1/tweeters-96k.wav"
                    ],
                    "channel": 0,
-                    "gain": 1.2
+                    "gain": 1.1
                }
            },
            {
@@ -140,7 +94,7 @@
                        "/usr/share/t2-linux-audio/15_1/tweeters-96k.wav"
                    ],
                    "channel": 0,
-                    "gain": 1.2
+                    "gain": 1.1
                }
            },
            {
@@ -154,7 +108,7 @@
                        "/usr/share/t2-linux-audio/15_1/woofers-96k.wav"
                    ],
                    "channel": 0,
-                    "gain": 1.4
+                    "gain": 1.2
                }
            },
            {
@@ -168,7 +122,55 @@
                        "/usr/share/t2-linux-audio/15_1/woofers-96k.wav"
                    ],
                    "channel": 0,
-                    "gain": 1.4
+                    "gain": 1.2
+                }
+            },
+            {
+                "type": "lv2",
+                "plugin": "http://lsp-plug.in/plugins/lv2/mb_compressor_stereo",
+                "name": "wmb_comp",
+                "control": {
+                    "enabled": 1,
+                    "mode": 1,
+                    "g_in": 1.0,
+                    "g_out": 1.1,
+                    "g_dry": 0.0001,
+                    "g_wet": 1.0,
+                    "cbe_1": 1, "sf_1": 40.0,
+                    "cbe_2": 1, "sf_2": 50.0,
+                    "cbe_3": 1, "sf_3": 60.0,
+                    "cbe_4": 1, "sf_4": 80.0,
+                    "cbe_5": 1, "sf_5": 120.0,
+                    "cbe_6": 1, "sf_6": 200.0,
+                    "cbe_7": 1, "sf_7": 500.0,
+                    "ce_0": 1, "at_0": 5.0, "rt_0": 100.0, "cr_0": 30.0, "kn_0": 0.10, "al_0": 0.95, "mk_0": 1.0, "bth_0": 1.0, "bsa_0": 1.0, "scm_0": 0,
+                    "ce_1": 1, "at_1": 6.0, "rt_1": 110.0, "cr_1": 30.0, "kn_1": 0.10, "al_1": 0.92, "mk_1": 1.0, "bth_1": 1.0, "bsa_1": 1.0, "scm_1": 0,
+                    "ce_2": 1, "at_2": 6.0, "rt_2": 100.0, "cr_2": 25.0, "kn_2": 0.12, "al_2": 0.90, "mk_2": 1.0, "bth_2": 1.0, "bsa_2": 1.0, "scm_2": 0,
+                    "ce_3": 1, "at_3": 5.0, "rt_3": 90.0,  "cr_3": 20.0, "kn_3": 0.12, "al_3": 0.88, "mk_3": 1.0, "bth_3": 1.0, "bsa_3": 1.0, "scm_3": 0,
+                    "ce_4": 1, "at_4": 4.5, "rt_4": 80.0,  "cr_4": 16.0, "kn_4": 0.15, "al_4": 0.85, "mk_4": 1.0, "bth_4": 1.0, "bsa_4": 1.0, "scm_4": 0,
+                    "ce_5": 1, "at_5": 4.0, "rt_5": 60.0,  "cr_5": 10.0, "kn_5": 0.20, "al_5": 0.80, "mk_5": 1.0, "bth_5": 1.0, "bsa_5": 1.0, "scm_5": 0,
+                    "ce_6": 1, "at_6": 3.0, "rt_6": 40.0,  "cr_6": 6.0,  "kn_6": 0.30, "al_6": 0.80, "mk_6": 1.0, "bth_6": 1.0, "bsa_6": 1.0, "scm_6": 0,
+                    "ce_7": 1, "at_7": 2.5, "rt_7": 30.0,  "cr_7": 4.0,  "kn_7": 0.40, "al_7": 0.80, "mk_7": 1.0, "bth_7": 1.0, "bsa_7": 1.0, "scm_7": 0
+                }
+            },
+            {
+                "type": "lv2",
+                "plugin": "http://lsp-plug.in/plugins/lv2/mb_compressor_stereo",
+                "name": "tmb_comp",
+                "control": {
+                    "enabled": 1,
+                    "mode": 1,
+                    "g_in": 1.0,
+                    "g_out": 1.0,
+                    "g_dry": 0.0001,
+                    "g_wet": 1.0,
+                    "cbe_1": 1, "sf_1": 2500.0,
+                    "cbe_2": 1, "sf_2": 6000.0,
+                    "cbe_3": 1, "sf_3": 12000.0,
+                    "ce_0": 1, "at_0": 3.0, "rt_0": 50.0, "cr_0": 8.0, "kn_0": 0.20, "al_0": 0.85, "mk_0": 1.0, "bth_0": 1.0, "bsa_0": 1.0, "scm_0": 0,
+                    "ce_1": 1, "at_1": 2.5, "rt_1": 40.0, "cr_1": 6.0, "kn_1": 0.30, "al_1": 0.80, "mk_1": 1.0, "bth_1": 1.0, "bsa_1": 1.0, "scm_1": 0,
+                    "ce_2": 1, "at_2": 2.0, "rt_2": 30.0, "cr_2": 4.0, "kn_2": 0.40, "al_2": 0.75, "mk_2": 1.0, "bth_2": 1.0, "bsa_2": 1.0, "scm_2": 0,
+                    "ce_3": 1, "at_3": 1.5, "rt_3": 20.0, "cr_3": 3.0, "kn_3": 0.50, "al_3": 0.70, "mk_3": 1.0, "bth_3": 1.0, "bsa_3": 1.0, "scm_3": 0
                }
            },
            {
@@ -177,7 +179,7 @@
                "plugin": "http://plugin.org.uk/swh-plugins/fastLookaheadLimiter",
                "control": {
                    "ingain": 0,
-                    "limit": -2,
+                    "limit": 0,
                    "release": 0.25
                }
            },
@@ -193,48 +195,36 @@
            }
        ],
        "links": [
-            {"output": "equalizer:out_l", "input": "virtualbass:in_l"},
-            {"output": "equalizer:out_r", "input": "virtualbass:in_r"},
-            {"output": "virtualbass:out_l", "input": "multiband_compressor:in_l"},
-            {"output": "virtualbass:out_r", "input": "multiband_compressor:in_r"},
-            {"output": "multiband_compressor:out_l", "input": "limiter:in_1"},
-            {"output": "multiband_compressor:out_r", "input": "limiter:in_2"},
-            {"output": "limiter:out_1", "input": "ell:in"},
-            {"output": "limiter:out_2", "input": "elr:in"},
-            {"output": "ell:out", "input": "copyL:In"},
-            {"output": "elr:out", "input": "copyR:In"},
+            {"output": "user_eq:out_l", "input": "virtualbass:in_l"},
+            {"output": "user_eq:out_r", "input": "virtualbass:in_r"},
+            {"output": "virtualbass:out_l", "input": "equalizer:in_l"},
+            {"output": "virtualbass:out_r", "input": "equalizer:in_r"},
+            {"output": "equalizer:out_l", "input": "loudness:in_l"},
+            {"output": "equalizer:out_r", "input": "loudness:in_r"},
+            {"output": "loudness:out_l", "input": "copyL:In"},
+            {"output": "loudness:out_r", "input": "copyR:In"},
            {"output": "copyL:Out", "input": "convLT:In"},
            {"output": "copyL:Out", "input": "convLW:In"},
            {"output": "copyR:Out", "input": "convRT:In"},
            {"output": "copyR:Out", "input": "convRW:In"},
-            {"output": "convLW:Out", "input": "wlim:in_1"},
-            {"output": "convRW:Out", "input": "wlim:in_2"},
-            {"output": "convLT:Out", "input": "tlim:in_1"},
-            {"output": "convRT:Out", "input": "tlim:in_2"}
+            {"output": "convLW:Out", "input": "wmb_comp:in_l"},
+            {"output": "convRW:Out", "input": "wmb_comp:in_r"},
+            {"output": "wmb_comp:out_l", "input": "wlim:in_1"},
+            {"output": "wmb_comp:out_r", "input": "wlim:in_2"},
+            {"output": "convLT:Out", "input": "tmb_comp:in_l"},
+            {"output": "convRT:Out", "input": "tmb_comp:in_r"},
+            {"output": "tmb_comp:out_l", "input": "tlim:in_1"},
+            {"output": "tmb_comp:out_r", "input": "tlim:in_2"}
        ],
        "inputs": [
-            "equalizer:in_l",
-            "equalizer:in_r"
+            "user_eq:in_l",
+            "user_eq:in_r"
        ],
        "outputs": [
            "wlim:out_1",
            "wlim:out_2",
            "tlim:out_1",
            "tlim:out_2"
-        ],
-        "capture.volumes": [
-            {
-                "control": "ell:volume",
-                "min": -65.0,
-                "max": 0.0,
-                "scale": "cubic"
-            },
-            {
-                "control": "elr:volume",
-                "min": -65.0,
-                "max": 0.0,
-                "scale": "cubic"
-            }
        ]
    },
    "capture.props": {
@@ -245,7 +235,8 @@
        "device.api": "dsp",
        "audio.allowed-rates": [48000, 44100],
        "node.virtual": "false",
-        "priority.session": 1500,
+        "priority.session": 2500,
+        "priority.driver": 2500,
        "state.default-volume": 1.0,
        "device.icon-name": "audio-speakers"
    },
--- a/graph_merged.json
+++ b/graph_merged.json
@@ -0,0 +1,502 @@
+{
+  "node.description": "MacBook Pro 15,1 Audio DSP",
+  "media.name": "MacBook Pro 15,1 Audio DSP",
+  "filter.graph": {
+    "nodes": [
+      {
+        "type": "lv2",
+        "plugin": "http://lsp-plug.in/plugins/lv2/para_equalizer_x16_stereo",
+        "name": "user_eq",
+        "control": {
+          "enabled": 1,
+          "mode": 0,
+          "g_in": 1.0,
+          "g_out": 1.40,
+          "ft_0": 5,
+          "f_0": 70.0,
+          "g_0": 1.15,
+          "q_0": 0.7,
+          "s_0": 0,
+          "ft_1": 1,
+          "f_1": 110.0,
+          "g_1": 1.1,
+          "q_1": 1.0,
+          "ft_2": 1,
+          "f_2": 315.0,
+          "g_2": 1.05,
+          "q_2": 1.0,
+          "ft_3": 1,
+          "f_3": 1000.0,
+          "g_3": 1.01,
+          "q_3": 1.0,
+          "ft_4": 1,
+          "f_4": 2500.0,
+          "g_4": 1.00,
+          "q_4": 1.0,
+          "ft_5": 1,
+          "f_5": 6000.0,
+          "g_5": 0.92,
+          "q_5": 1.0,
+          "ft_6": 3,
+          "f_6": 10000.0,
+          "g_6": 0.85,
+          "q_6": 0.7,
+          "ft_7": 3,
+          "f_7": 16000.0,
+          "g_7": 0.80,
+          "q_7": 0.7,
+          "s_7": 0
+        }
+      },
+      {
+        "type": "lv2",
+        "plugin": "https://chadmed.au/bankstown",
+        "name": "virtualbass",
+        "control": {
+          "amt": 1.4,
+          "floor": 40.0,
+          "ceil": 120.0,
+          "final_hp": 55.0,
+          "sat_second": 1.0,
+          "sat_third": 1.0,
+          "blend": 0.30
+        }
+      },
+      {
+        "type": "lv2",
+        "plugin": "http://lsp-plug.in/plugins/lv2/para_equalizer_x16_stereo",
+        "name": "equalizer",
+        "control": {
+          "enabled": 1,
+          "mode": 0,
+          "g_in": 1.0,
+          "g_out": 1.0,
+          "ft_0": 5,
+          "f_0": 40.0,
+          "g_0": 2.83,
+          "q_0": 0.70,
+          "ft_1": 1,
+          "f_1": 80.0,
+          "g_1": 2.00,
+          "q_1": 1.00,
+          "ft_2": 1,
+          "f_2": 160.0,
+          "g_2": 1.41,
+          "q_2": 1.00,
+          "ft_3": 1,
+          "f_3": 320.0,
+          "g_3": 1.00,
+          "q_3": 1.00,
+          "ft_4": 1,
+          "f_4": 640.0,
+          "g_4": 0.71,
+          "q_4": 1.00,
+          "ft_5": 1,
+          "f_5": 1280.0,
+          "g_5": 0.50,
+          "q_5": 1.00,
+          "ft_6": 1,
+          "f_6": 2560.0,
+          "g_6": 0.35,
+          "q_6": 1.00,
+          "ft_7": 3,
+          "f_7": 12000.0,
+          "g_7": 0.24,
+          "q_7": 0.70
+        }
+      },
+      {
+        "type": "lv2",
+        "plugin": "http://lsp-plug.in/plugins/lv2/loud_comp_stereo",
+        "name": "loudness",
+        "control": {
+          "enabled": 1,
+          "input": 1.0,
+          "fft": 1
+        }
+      },
+      {
+        "type": "builtin",
+        "label": "copy",
+        "name": "copyL"
+      },
+      {
+        "type": "builtin",
+        "label": "copy",
+        "name": "copyR"
+      },
+      {
+        "type": "builtin",
+        "label": "convolver",
+        "name": "convLT",
+        "config": {
+          "filename": [
+            "/usr/share/t2-linux-audio/15_1/tweeters-44k.wav",
+            "/usr/share/t2-linux-audio/15_1/tweeters-48k.wav",
+            "/usr/share/t2-linux-audio/15_1/tweeters-96k.wav"
+          ],
+          "channel": 0,
+          "gain": 1.1
+        }
+      },
+      {
+        "type": "builtin",
+        "label": "convolver",
+        "name": "convRT",
+        "config": {
+          "filename": [
+            "/usr/share/t2-linux-audio/15_1/tweeters-44k.wav",
+            "/usr/share/t2-linux-audio/15_1/tweeters-48k.wav",
+            "/usr/share/t2-linux-audio/15_1/tweeters-96k.wav"
+          ],
+          "channel": 0,
+          "gain": 1.1
+        }
+      },
+      {
+        "type": "builtin",
+        "label": "convolver",
+        "name": "convLW",
+        "config": {
+          "filename": [
+            "/usr/share/t2-linux-audio/15_1/woofers-44k.wav",
+            "/usr/share/t2-linux-audio/15_1/woofers-48k.wav",
+            "/usr/share/t2-linux-audio/15_1/woofers-96k.wav"
+          ],
+          "channel": 0,
+          "gain": 1.2
+        }
+      },
+      {
+        "type": "builtin",
+        "label": "convolver",
+        "name": "convRW",
+        "config": {
+          "filename": [
+            "/usr/share/t2-linux-audio/15_1/woofers-44k.wav",
+            "/usr/share/t2-linux-audio/15_1/woofers-48k.wav",
+            "/usr/share/t2-linux-audio/15_1/woofers-96k.wav"
+          ],
+          "channel": 0,
+          "gain": 1.2
+        }
+      },
+      {
+        "type": "lv2",
+        "plugin": "http://lsp-plug.in/plugins/lv2/mb_compressor_stereo",
+        "name": "wmb_comp",
+        "control": {
+          "enabled": 1,
+          "mode": 1,
+          "g_in": 1.0,
+          "g_out": 1.1,
+          "g_dry": 0.0001,
+          "g_wet": 1.0,
+          "cbe_1": 1,
+          "sf_1": 40.0,
+          "cbe_2": 1,
+          "sf_2": 50.0,
+          "cbe_3": 1,
+          "sf_3": 60.0,
+          "cbe_4": 1,
+          "sf_4": 80.0,
+          "cbe_5": 1,
+          "sf_5": 120.0,
+          "cbe_6": 1,
+          "sf_6": 200.0,
+          "cbe_7": 1,
+          "sf_7": 500.0,
+          "ce_0": 1,
+          "at_0": 5.0,
+          "rt_0": 100.0,
+          "cr_0": 30.0,
+          "kn_0": 0.10,
+          "al_0": 0.95,
+          "mk_0": 1.0,
+          "bth_0": 1.0,
+          "bsa_0": 1.0,
+          "scm_0": 0,
+          "ce_1": 1,
+          "at_1": 6.0,
+          "rt_1": 110.0,
+          "cr_1": 30.0,
+          "kn_1": 0.10,
+          "al_1": 0.92,
+          "mk_1": 1.0,
+          "bth_1": 1.0,
+          "bsa_1": 1.0,
+          "scm_1": 0,
+          "ce_2": 1,
+          "at_2": 6.0,
+          "rt_2": 100.0,
+          "cr_2": 25.0,
+          "kn_2": 0.12,
+          "al_2": 0.90,
+          "mk_2": 1.0,
+          "bth_2": 1.0,
+          "bsa_2": 1.0,
+          "scm_2": 0,
+          "ce_3": 1,
+          "at_3": 5.0,
+          "rt_3": 90.0,
+          "cr_3": 20.0,
+          "kn_3": 0.12,
+          "al_3": 0.88,
+          "mk_3": 1.0,
+          "bth_3": 1.0,
+          "bsa_3": 1.0,
+          "scm_3": 0,
+          "ce_4": 1,
+          "at_4": 4.5,
+          "rt_4": 80.0,
+          "cr_4": 16.0,
+          "kn_4": 0.15,
+          "al_4": 0.85,
+          "mk_4": 1.0,
+          "bth_4": 1.0,
+          "bsa_4": 1.0,
+          "scm_4": 0,
+          "ce_5": 1,
+          "at_5": 4.0,
+          "rt_5": 60.0,
+          "cr_5": 10.0,
+          "kn_5": 0.20,
+          "al_5": 0.80,
+          "mk_5": 1.0,
+          "bth_5": 1.0,
+          "bsa_5": 1.0,
+          "scm_5": 0,
+          "ce_6": 1,
+          "at_6": 3.0,
+          "rt_6": 40.0,
+          "cr_6": 6.0,
+          "kn_6": 0.30,
+          "al_6": 0.80,
+          "mk_6": 1.0,
+          "bth_6": 1.0,
+          "bsa_6": 1.0,
+          "scm_6": 0,
+          "ce_7": 1,
+          "at_7": 2.5,
+          "rt_7": 30.0,
+          "cr_7": 4.0,
+          "kn_7": 0.40,
+          "al_7": 0.80,
+          "mk_7": 1.0,
+          "bth_7": 1.0,
+          "bsa_7": 1.0,
+          "scm_7": 0
+        }
+      },
+      {
+        "type": "lv2",
+        "plugin": "http://lsp-plug.in/plugins/lv2/mb_compressor_stereo",
+        "name": "tmb_comp",
+        "control": {
+          "enabled": 1,
+          "mode": 1,
+          "g_in": 1.0,
+          "g_out": 1.0,
+          "g_dry": 0.0001,
+          "g_wet": 1.0,
+          "cbe_1": 1,
+          "sf_1": 2500.0,
+          "cbe_2": 1,
+          "sf_2": 6000.0,
+          "cbe_3": 1,
+          "sf_3": 12000.0,
+          "ce_0": 1,
+          "at_0": 3.0,
+          "rt_0": 50.0,
+          "cr_0": 8.0,
+          "kn_0": 0.20,
+          "al_0": 0.85,
+          "mk_0": 1.0,
+          "bth_0": 1.0,
+          "bsa_0": 1.0,
+          "scm_0": 0,
+          "ce_1": 1,
+          "at_1": 2.5,
+          "rt_1": 40.0,
+          "cr_1": 6.0,
+          "kn_1": 0.30,
+          "al_1": 0.80,
+          "mk_1": 1.0,
+          "bth_1": 1.0,
+          "bsa_1": 1.0,
+          "scm_1": 0,
+          "ce_2": 1,
+          "at_2": 2.0,
+          "rt_2": 30.0,
+          "cr_2": 4.0,
+          "kn_2": 0.40,
+          "al_2": 0.75,
+          "mk_2": 1.0,
+          "bth_2": 1.0,
+          "bsa_2": 1.0,
+          "scm_2": 0,
+          "ce_3": 1,
+          "at_3": 1.5,
+          "rt_3": 20.0,
+          "cr_3": 3.0,
+          "kn_3": 0.50,
+          "al_3": 0.70,
+          "mk_3": 1.0,
+          "bth_3": 1.0,
+          "bsa_3": 1.0,
+          "scm_3": 0
+        }
+      },
+      {
+        "type": "lv2",
+        "name": "wlim",
+        "plugin": "http://plugin.org.uk/swh-plugins/fastLookaheadLimiter",
+        "control": {
+          "ingain": 0,
+          "limit": 0,
+          "release": 0.25
+        }
+      },
+      {
+        "type": "lv2",
+        "name": "tlim",
+        "plugin": "http://plugin.org.uk/swh-plugins/fastLookaheadLimiter",
+        "control": {
+          "ingain": 0,
+          "limit": -1,
+          "release": 0.15
+        }
+      }
+    ],
+    "links": [
+      {
+        "output": "user_eq:out_l",
+        "input": "virtualbass:in_l"
+      },
+      {
+        "output": "user_eq:out_r",
+        "input": "virtualbass:in_r"
+      },
+      {
+        "output": "virtualbass:out_l",
+        "input": "equalizer:in_l"
+      },
+      {
+        "output": "virtualbass:out_r",
+        "input": "equalizer:in_r"
+      },
+      {
+        "output": "equalizer:out_l",
+        "input": "loudness:in_l"
+      },
+      {
+        "output": "equalizer:out_r",
+        "input": "loudness:in_r"
+      },
+      {
+        "output": "loudness:out_l",
+        "input": "copyL:In"
+      },
+      {
+        "output": "loudness:out_r",
+        "input": "copyR:In"
+      },
+      {
+        "output": "copyL:Out",
+        "input": "convLT:In"
+      },
+      {
+        "output": "copyL:Out",
+        "input": "convLW:In"
+      },
+      {
+        "output": "copyR:Out",
+        "input": "convRT:In"
+      },
+      {
+        "output": "copyR:Out",
+        "input": "convRW:In"
+      },
+      {
+        "output": "convLW:Out",
+        "input": "wmb_comp:in_l"
+      },
+      {
+        "output": "convRW:Out",
+        "input": "wmb_comp:in_r"
+      },
+      {
+        "output": "wmb_comp:out_l",
+        "input": "wlim:in_1"
+      },
+      {
+        "output": "wmb_comp:out_r",
+        "input": "wlim:in_2"
+      },
+      {
+        "output": "convLT:Out",
+        "input": "tmb_comp:in_l"
+      },
+      {
+        "output": "convRT:Out",
+        "input": "tmb_comp:in_r"
+      },
+      {
+        "output": "tmb_comp:out_l",
+        "input": "tlim:in_1"
+      },
+      {
+        "output": "tmb_comp:out_r",
+        "input": "tlim:in_2"
+      }
+    ],
+    "inputs": [
+      "user_eq:in_l",
+      "user_eq:in_r"
+    ],
+    "outputs": [
+      "wlim:out_1",
+      "wlim:out_2",
+      "tlim:out_1",
+      "tlim:out_2"
+    ]
+  },
+  "capture.props": {
+    "node.name": "audio_effect.t2-151-speakers",
+    "media.class": "Audio/Sink",
+    "audio.channels": "2",
+    "audio.position": [
+      "FL",
+      "FR"
+    ],
+    "device.api": "dsp",
+    "audio.allowed-rates": [
+      48000,
+      44100
+    ],
+    "node.virtual": "false",
+    "priority.session": 2500,
+    "priority.driver": 2500,
+    "state.default-volume": 1.0,
+    "device.icon-name": "audio-speakers"
+  },
+  "playback.props": {
+    "node.name": "effect_output.t2-151-speakers",
+    "node.description": "MacBook Pro 15,1 DSP Speakers Out",
+    "media.name": "MacBook Pro 15,1 DSP Speakers Out",
+    "target.object": "alsa_output.platform-sound.RawSpeakers",
+    "node.dont-fallback": "true",
+    "node.passive": "true",
+    "audio.channels": "4",
+    "audio.allowed-rates": [
+      48000,
+      44100
+    ],
+    "audio.position": [
+      "FL",
+      "FR",
+      "RL",
+      "RR"
+    ]
+  }
+}
--- a/install-deps.sh
+++ b/install-deps.sh
@@ -0,0 +1,127 @@
+#!/bin/bash
+# Install the LV2 plugins this DSP graph loads:
+#   LSP Plugins  - para_equalizer_x16_stereo, mb_compressor_stereo, loud_comp_mono
+#   SWH Plugins  - fastLookaheadLimiter
+#   Bankstown    - https://chadmed.au/bankstown   (built from source)
+#
+# Does NOT install the t2 speaker-DSP package (FIR .wav files + the WirePlumber
+# splice that creates the sink). See INSTALL.md sections 1 and 4 for that.
+
+set -u
+
+SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd -P)"
+BUILD_DIR="$SCRIPT_DIR/build"
+
+URIS=(
+    http://lsp-plug.in/plugins/lv2/para_equalizer_x16_stereo
+    http://lsp-plug.in/plugins/lv2/mb_compressor_stereo
+    http://lsp-plug.in/plugins/lv2/loud_comp_mono
+    http://plugin.org.uk/swh-plugins/fastLookaheadLimiter
+    https://chadmed.au/bankstown
+)
+
+have()     { command -v "$1" >/dev/null 2>&1; }
+lv2_have() { have lv2ls && lv2ls 2>/dev/null | grep -qxF "$1"; }
+
+SUDO=""
+if [ "$(id -u)" -ne 0 ]; then
+    if have sudo; then SUDO="sudo"; else
+        echo "Error: run as root or install sudo." >&2; exit 1
+    fi
+fi
+
+if   have dnf;    then PM=dnf
+elif have pacman; then PM=pacman
+elif have apt;    then PM=apt
+elif have zypper; then PM=zypper
+else PM=""; fi
+
+have lv2ls || echo "note: lv2ls not found - install 'lilv-utils' (deb) / 'lilv' (arch/fedora) to verify URIs"
+
+# ---------------------------------------------------------------- LSP + SWH
+need_lsp=1; need_swh=1
+lv2_have http://lsp-plug.in/plugins/lv2/para_equalizer_x16_stereo && need_lsp=0
+lv2_have http://plugin.org.uk/swh-plugins/fastLookaheadLimiter    && need_swh=0
+
+pkgs=()
+[ "$need_lsp" -eq 1 ] && pkgs+=(lsp-plugins)
+[ "$need_swh" -eq 1 ] && pkgs+=(swh-plugins)
+have jq || pkgs+=(jq)             # apply.sh needs jq for the user_eq override
+if ! have lv2ls; then
+    case "$PM" in
+        apt)               pkgs+=(lilv-utils) ;;
+        dnf|zypper|pacman) pkgs+=(lilv) ;;
+    esac
+fi
+
+if [ "${#pkgs[@]}" -gt 0 ]; then
+    if [ -z "$PM" ]; then
+        echo "!! No supported package manager (dnf/pacman/apt/zypper). Install manually: ${pkgs[*]}"
+        exit 1
+    fi
+    echo "==> Installing ${pkgs[*]} via $PM"
+    case "$PM" in
+        dnf)    $SUDO dnf install -y "${pkgs[@]}" ;;
+        pacman) $SUDO pacman -S --needed --noconfirm "${pkgs[@]}" ;;
+        apt)    $SUDO apt-get update && $SUDO apt-get install -y "${pkgs[@]}" ;;
+        zypper) $SUDO zypper install -y "${pkgs[@]}" ;;
+    esac
+else
+    echo "==> LSP + SWH already present"
+fi
+
+# ---------------------------------------------------------------- Bankstown
+if lv2_have https://chadmed.au/bankstown; then
+    echo "==> Bankstown already present"
+else
+    echo "==> Building Bankstown from source"
+    missing=()
+    have git   || missing+=(git)
+    have cargo || missing+=(rust/cargo)
+    { have cc || have clang; } || missing+=(clang)
+    if [ "${#missing[@]}" -gt 0 ]; then
+        echo "!! Missing build tools: ${missing[*]}"
+        echo "   Fedora: $SUDO dnf install git rust cargo clang"
+        echo "   Arch:   $SUDO pacman -S git rust clang"
+        echo "   Debian: $SUDO apt install git cargo clang"
+        exit 1
+    fi
+
+    LIBDIR=/usr/lib64
+    [ -d /usr/lib64/lv2 ] || [ -d /usr/lib64 ] || LIBDIR=/usr/lib
+
+    mkdir -p "$BUILD_DIR"
+    if [ -d "$BUILD_DIR/bankstown/.git" ]; then
+        git -C "$BUILD_DIR/bankstown" pull --ff-only
+    else
+        git clone https://github.com/chadmed/bankstown "$BUILD_DIR/bankstown"
+    fi
+    make -C "$BUILD_DIR/bankstown"                       # -> cargo build --release
+    $SUDO make -C "$BUILD_DIR/bankstown" install LIBDIR="$LIBDIR"
+    echo "   installed to $LIBDIR/lv2/bankstown.lv2/"
+fi
+
+# ---------------------------------------------------------------- verify
+echo
+echo "==> Verifying plugin URIs"
+fail=0
+if have lv2ls; then
+    for u in "${URIS[@]}"; do
+        if lv2ls | grep -qxF "$u"; then
+            echo "   ok       $u"
+        else
+            echo "   MISSING  $u"; fail=1
+        fi
+    done
+else
+    echo "   lv2ls unavailable - skipping"
+    fail=1
+fi
+
+echo
+if [ "$fail" -eq 0 ]; then
+    echo "All plugins resolve. Next: ./apply.sh"
+else
+    echo "Not all plugins resolve - see INSTALL.md section 3."
+    exit 1
+fi
--- a/laptop-configs/apple/mbp15_1/graph.json
+++ b/laptop-configs/apple/mbp15_1/graph.json
@@ -0,0 +1,254 @@
+{
+    "node.description": "MacBook Pro 15,1 Audio DSP",
+    "media.name": "MacBook Pro 15,1 Audio DSP",
+    "filter.graph": {
+        "nodes": [
+            {
+                "type": "lv2",
+                "plugin": "http://lsp-plug.in/plugins/lv2/para_equalizer_x16_stereo",
+                "name": "user_eq",
+                "control": {
+                    "enabled": 1, "mode": 0, "g_in": 1.0, "g_out": 1.5,
+                    "ft_0": 5, "f_0": 70.0,   "g_0": 1.00, "q_0": 0.70, "s_0": 0,
+                    "ft_1": 1, "f_1": 110.0,  "g_1": 1.00, "q_1": 1.00,
+                    "ft_2": 1, "f_2": 315.0,  "g_2": 1.00, "q_2": 1.00,
+                    "ft_3": 1, "f_3": 600.0,  "g_3": 1.00, "q_3": 1.00,
+                    "ft_4": 1, "f_4": 1000.0, "g_4": 1.00, "q_4": 1.00,
+                    "ft_5": 1, "f_5": 2500.0, "g_5": 1.00, "q_5": 1.00,
+                    "ft_6": 1, "f_6": 6000.0, "g_6": 1.00, "q_6": 1.00,
+                    "ft_7": 3, "f_7": 12000.0,"g_7": 1.00, "q_7": 0.70, "s_7": 0
+                }
+            },
+            {
+                "type": "lv2",
+                "plugin": "https://chadmed.au/bankstown",
+                "name": "virtualbass",
+                "control": {
+                    "amt": 1.4,
+                    "floor": 40.0,
+                    "ceil": 120.0,
+                    "final_hp": 55.0,
+                    "sat_second": 1.0,
+                    "sat_third": 1.0,
+                    "blend": 0.30
+                }
+            },
+            {
+                "type": "lv2",
+                "plugin": "http://lsp-plug.in/plugins/lv2/para_equalizer_x16_stereo",
+                "name": "equalizer",
+                "control": {
+                    "enabled": 1, "mode": 0, "g_in": 1.0, "g_out": 1.0,
+                    "ft_0": 5, "f_0": 40.0,   "g_0": 2.83, "q_0": 0.70,
+                    "ft_1": 1, "f_1": 80.0,   "g_1": 2.00, "q_1": 1.00,
+                    "ft_2": 1, "f_2": 160.0,  "g_2": 1.41, "q_2": 1.00,
+                    "ft_3": 1, "f_3": 320.0,  "g_3": 1.00, "q_3": 1.00,
+                    "ft_4": 1, "f_4": 640.0,  "g_4": 0.71, "q_4": 1.00,
+                    "ft_5": 1, "f_5": 1280.0, "g_5": 0.50, "q_5": 1.00,
+                    "ft_6": 1, "f_6": 2560.0, "g_6": 0.35, "q_6": 1.00,
+                    "ft_7": 3, "f_7": 12000.0,"g_7": 0.24, "q_7": 0.70
+                }
+            },
+            {
+                "type": "lv2",
+                "plugin": "http://lsp-plug.in/plugins/lv2/loud_comp_stereo",
+                "name": "loudness",
+                "control": {
+                    "enabled": 1,
+                    "input": 1.0,
+                    "fft": 1
+                }
+            },
+            {
+                "type": "builtin",
+                "label": "copy",
+                "name": "copyL"
+            },
+            {
+                "type": "builtin",
+                "label": "copy",
+                "name": "copyR"
+            },
+            {
+                "type": "builtin",
+                "label": "convolver",
+                "name": "convLT",
+                "config": {
+                    "filename": [
+                        "/usr/share/t2-linux-audio/15_1/tweeters-44k.wav",
+                        "/usr/share/t2-linux-audio/15_1/tweeters-48k.wav",
+                        "/usr/share/t2-linux-audio/15_1/tweeters-96k.wav"
+                    ],
+                    "channel": 0,
+                    "gain": 1.1
+                }
+            },
+            {
+                "type": "builtin",
+                "label": "convolver",
+                "name": "convRT",
+                "config": {
+                    "filename": [
+                        "/usr/share/t2-linux-audio/15_1/tweeters-44k.wav",
+                        "/usr/share/t2-linux-audio/15_1/tweeters-48k.wav",
+                        "/usr/share/t2-linux-audio/15_1/tweeters-96k.wav"
+                    ],
+                    "channel": 0,
+                    "gain": 1.1
+                }
+            },
+            {
+                "type": "builtin",
+                "label": "convolver",
+                "name": "convLW",
+                "config": {
+                    "filename": [
+                        "/usr/share/t2-linux-audio/15_1/woofers-44k.wav",
+                        "/usr/share/t2-linux-audio/15_1/woofers-48k.wav",
+                        "/usr/share/t2-linux-audio/15_1/woofers-96k.wav"
+                    ],
+                    "channel": 0,
+                    "gain": 1.2
+                }
+            },
+            {
+                "type": "builtin",
+                "label": "convolver",
+                "name": "convRW",
+                "config": {
+                    "filename": [
+                        "/usr/share/t2-linux-audio/15_1/woofers-44k.wav",
+                        "/usr/share/t2-linux-audio/15_1/woofers-48k.wav",
+                        "/usr/share/t2-linux-audio/15_1/woofers-96k.wav"
+                    ],
+                    "channel": 0,
+                    "gain": 1.2
+                }
+            },
+            {
+                "type": "lv2",
+                "plugin": "http://lsp-plug.in/plugins/lv2/mb_compressor_stereo",
+                "name": "wmb_comp",
+                "control": {
+                    "enabled": 1,
+                    "mode": 1,
+                    "g_in": 1.0,
+                    "g_out": 1.0,
+                    "g_dry": 0.0001,
+                    "g_wet": 1.0,
+                    "cbe_1": 1, "sf_1": 40.0,
+                    "cbe_2": 1, "sf_2": 50.0,
+                    "cbe_3": 1, "sf_3": 60.0,
+                    "cbe_4": 1, "sf_4": 80.0,
+                    "cbe_5": 1, "sf_5": 120.0,
+                    "cbe_6": 1, "sf_6": 200.0,
+                    "cbe_7": 1, "sf_7": 500.0,
+                    "ce_0": 1, "at_0": 5.0, "rt_0": 100.0, "cr_0": 30.0, "kn_0": 0.10, "al_0": 0.95, "mk_0": 1.0, "bth_0": 1.0, "bsa_0": 1.0, "scm_0": 0,
+                    "ce_1": 1, "at_1": 6.0, "rt_1": 110.0, "cr_1": 30.0, "kn_1": 0.10, "al_1": 0.92, "mk_1": 1.0, "bth_1": 1.0, "bsa_1": 1.0, "scm_1": 0,
+                    "ce_2": 1, "at_2": 6.0, "rt_2": 100.0, "cr_2": 25.0, "kn_2": 0.12, "al_2": 0.90, "mk_2": 1.0, "bth_2": 1.0, "bsa_2": 1.0, "scm_2": 0,
+                    "ce_3": 1, "at_3": 5.0, "rt_3": 90.0,  "cr_3": 20.0, "kn_3": 0.12, "al_3": 0.88, "mk_3": 1.0, "bth_3": 1.0, "bsa_3": 1.0, "scm_3": 0,
+                    "ce_4": 1, "at_4": 4.5, "rt_4": 80.0,  "cr_4": 16.0, "kn_4": 0.15, "al_4": 0.85, "mk_4": 1.0, "bth_4": 1.0, "bsa_4": 1.0, "scm_4": 0,
+                    "ce_5": 1, "at_5": 4.0, "rt_5": 60.0,  "cr_5": 10.0, "kn_5": 0.20, "al_5": 0.80, "mk_5": 1.0, "bth_5": 1.0, "bsa_5": 1.0, "scm_5": 0,
+                    "ce_6": 1, "at_6": 3.0, "rt_6": 40.0,  "cr_6": 6.0,  "kn_6": 0.30, "al_6": 0.80, "mk_6": 1.0, "bth_6": 1.0, "bsa_6": 1.0, "scm_6": 0,
+                    "ce_7": 1, "at_7": 2.5, "rt_7": 30.0,  "cr_7": 4.0,  "kn_7": 0.40, "al_7": 0.80, "mk_7": 1.0, "bth_7": 1.0, "bsa_7": 1.0, "scm_7": 0
+                }
+            },
+            {
+                "type": "lv2",
+                "plugin": "http://lsp-plug.in/plugins/lv2/mb_compressor_stereo",
+                "name": "tmb_comp",
+                "control": {
+                    "enabled": 1,
+                    "mode": 1,
+                    "g_in": 1.0,
+                    "g_out": 1.0,
+                    "g_dry": 0.0001,
+                    "g_wet": 1.0,
+                    "cbe_1": 1, "sf_1": 2500.0,
+                    "cbe_2": 1, "sf_2": 6000.0,
+                    "cbe_3": 1, "sf_3": 12000.0,
+                    "ce_0": 1, "at_0": 3.0, "rt_0": 50.0, "cr_0": 8.0, "kn_0": 0.20, "al_0": 0.85, "mk_0": 1.0, "bth_0": 1.0, "bsa_0": 1.0, "scm_0": 0,
+                    "ce_1": 1, "at_1": 2.5, "rt_1": 40.0, "cr_1": 6.0, "kn_1": 0.30, "al_1": 0.80, "mk_1": 1.0, "bth_1": 1.0, "bsa_1": 1.0, "scm_1": 0,
+                    "ce_2": 1, "at_2": 2.0, "rt_2": 30.0, "cr_2": 4.0, "kn_2": 0.40, "al_2": 0.75, "mk_2": 1.0, "bth_2": 1.0, "bsa_2": 1.0, "scm_2": 0,
+                    "ce_3": 1, "at_3": 1.5, "rt_3": 20.0, "cr_3": 3.0, "kn_3": 0.50, "al_3": 0.70, "mk_3": 1.0, "bth_3": 1.0, "bsa_3": 1.0, "scm_3": 0
+                }
+            },
+            {
+                "type": "lv2",
+                "name": "wlim",
+                "plugin": "http://plugin.org.uk/swh-plugins/fastLookaheadLimiter",
+                "control": {
+                    "ingain": 0,
+                    "limit": -2,
+                    "release": 0.25
+                }
+            },
+            {
+                "type": "lv2",
+                "name": "tlim",
+                "plugin": "http://plugin.org.uk/swh-plugins/fastLookaheadLimiter",
+                "control": {
+                    "ingain": 0,
+                    "limit": -1,
+                    "release": 0.15
+                }
+            }
+        ],
+        "links": [
+            {"output": "user_eq:out_l", "input": "virtualbass:in_l"},
+            {"output": "user_eq:out_r", "input": "virtualbass:in_r"},
+            {"output": "virtualbass:out_l", "input": "equalizer:in_l"},
+            {"output": "virtualbass:out_r", "input": "equalizer:in_r"},
+            {"output": "equalizer:out_l", "input": "loudness:in_l"},
+            {"output": "equalizer:out_r", "input": "loudness:in_r"},
+            {"output": "loudness:out_l", "input": "copyL:In"},
+            {"output": "loudness:out_r", "input": "copyR:In"},
+            {"output": "copyL:Out", "input": "convLT:In"},
+            {"output": "copyL:Out", "input": "convLW:In"},
+            {"output": "copyR:Out", "input": "convRT:In"},
+            {"output": "copyR:Out", "input": "convRW:In"},
+            {"output": "convLW:Out", "input": "wmb_comp:in_l"},
+            {"output": "convRW:Out", "input": "wmb_comp:in_r"},
+            {"output": "wmb_comp:out_l", "input": "wlim:in_1"},
+            {"output": "wmb_comp:out_r", "input": "wlim:in_2"},
+            {"output": "convLT:Out", "input": "tmb_comp:in_l"},
+            {"output": "convRT:Out", "input": "tmb_comp:in_r"},
+            {"output": "tmb_comp:out_l", "input": "tlim:in_1"},
+            {"output": "tmb_comp:out_r", "input": "tlim:in_2"}
+        ],
+        "inputs": [
+            "user_eq:in_l",
+            "user_eq:in_r"
+        ],
+        "outputs": [
+            "wlim:out_1",
+            "wlim:out_2",
+            "tlim:out_1",
+            "tlim:out_2"
+        ]
+    },
+    "capture.props": {
+        "node.name": "audio_effect.t2-151-speakers",
+        "media.class": "Audio/Sink",
+        "audio.channels": "2",
+        "audio.position": ["FL", "FR"],
+        "device.api": "dsp",
+        "audio.allowed-rates": [48000, 44100],
+        "node.virtual": "false",
+        "priority.session": 2500,
+        "priority.driver": 2500,
+        "state.default-volume": 1.0,
+        "device.icon-name": "audio-speakers"
+    },
+    "playback.props": {
+        "node.name": "effect_output.t2-151-speakers",
+        "node.description": "MacBook Pro 15,1 DSP Speakers Out",
+        "media.name": "MacBook Pro 15,1 DSP Speakers Out",
+        "target.object": "alsa_output.platform-sound.RawSpeakers",
+        "node.dont-fallback": "true",
+        "node.passive": "true",
+        "audio.channels": "4",
+        "audio.allowed-rates": [48000, 44100],
+        "audio.position": ["FL", "FR", "RL", "RR"]
+    }
+}
--- a/laptop-configs/apple/mbp15_1/profile.json
+++ b/laptop-configs/apple/mbp15_1/profile.json
@@ -0,0 +1,15 @@
+{
+    "id": "apple_mbp15_1",
+    "name": "MacBook Pro 15,1 (2018/2019)",
+    "vendor": "Apple Inc.",
+    "dmi_matches": [
+        "MacBookPro15,1",
+        "MacBookPro15,3"
+    ],
+    "sys_dir": "/usr/share/t2-linux-audio/15_1",
+    "channels": 4,
+    "crossover_freq_hz": 180.0,
+    "woofer_tail_taps": 16384,
+    "tweeter_tail_taps": 8192,
+    "lead_trim_ms": 5.0
+}
--- a/laptop-configs/apple/mbp15_1/tweeters-44k.wav
+++ b/laptop-configs/apple/mbp15_1/tweeters-44k.wav
--- a/laptop-configs/apple/mbp15_1/tweeters-48k.wav
+++ b/laptop-configs/apple/mbp15_1/tweeters-48k.wav
--- a/laptop-configs/apple/mbp15_1/tweeters-96k.wav
+++ b/laptop-configs/apple/mbp15_1/tweeters-96k.wav
--- a/laptop-configs/apple/mbp15_1/woofers-44k.wav
+++ b/laptop-configs/apple/mbp15_1/woofers-44k.wav
--- a/laptop-configs/apple/mbp15_1/woofers-48k.wav
+++ b/laptop-configs/apple/mbp15_1/woofers-48k.wav
--- a/laptop-configs/apple/mbp15_1/woofers-96k.wav
+++ b/laptop-configs/apple/mbp15_1/woofers-96k.wav
--- a/sweep-analyzer.py
+++ b/sweep-analyzer.py
@@ -0,0 +1,245 @@
+#!/usr/bin/env python3
+"""
+sweep-analyzer.py — Low-Volume Logarithmic Sine Sweep Analyzer
+
+Generates a low-amplitude (-20 dBFS) 20 Hz - 20 kHz logarithmic sine sweep
+that avoids triggering dynamic compressors or limiters.
+
+Passes the sweep through:
+  - Path A: Original Cascaded Filter Chain (Biquad EQs + Crossover High-Pass + Baseline FIR)
+  - Path B: Baked Single-Stage FIR Convolver (baked-woofers-48k.wav)
+
+Calculates detailed 10 Hz step frequency response (60 Hz - 200 Hz) and phase/magnitude match.
+Runs with pure standard-library Python 3.
+"""
+
+import os
+import sys
+import math
+import struct
+import json
+
+SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
+
+def read_wav_floats(filepath):
+    with open(filepath, 'rb') as f:
+        content = f.read()
+    if not content.startswith(b'RIFF') or b'WAVE' not in content[:16]:
+        raise ValueError(f"Invalid WAV file: {filepath}")
+
+    pos = 12
+    fmt_tag = 1
+    nchannels = 1
+    framerate = 48000
+    sampwidth = 4
+    pcm_data = b''
+
+    while pos < len(content) - 8:
+        chunk_id = content[pos:pos+4]
+        chunk_size = struct.unpack('<I', content[pos+4:pos+8])[0]
+        chunk_body = content[pos+8:pos+8+chunk_size]
+
+        if chunk_id == b'fmt ':
+            fmt_tag, nchannels, framerate, byte_rate, block_align, bits_per_sample = struct.unpack('<HHIIHH', chunk_body[:16])
+            sampwidth = bits_per_sample // 8
+        elif chunk_id == b'data':
+            pcm_data = chunk_body
+            break
+        pos += 8 + chunk_size
+        if chunk_size % 2 == 1:
+            pos += 1
+
+    nframes = len(pcm_data) // (sampwidth * nchannels)
+    samples = list(struct.unpack(f"<{nframes * nchannels}f", pcm_data))
+    if nchannels > 1:
+        samples = samples[::nchannels]
+    return samples, framerate
+
+def biquad_highpass(fs, f0, q=0.7071):
+    w0 = 2.0 * math.pi * f0 / fs
+    alpha = math.sin(w0) / (2.0 * q)
+    cos_w0 = math.cos(w0)
+    b0 = (1.0 + cos_w0) / 2.0
+    b1 = -(1.0 + cos_w0)
+    b2 = (1.0 + cos_w0) / 2.0
+    a0 = 1.0 + alpha
+    a1 = -2.0 * cos_w0
+    a2 = 1.0 - alpha
+    return b0/a0, b1/a0, b2/a0, 1.0, a1/a0, a2/a0
+
+def biquad_lowpass(fs, f0, q=0.7071):
+    w0 = 2.0 * math.pi * f0 / fs
+    alpha = math.sin(w0) / (2.0 * q)
+    cos_w0 = math.cos(w0)
+    b0 = (1.0 - cos_w0) / 2.0
+    b1 = 1.0 - cos_w0
+    b2 = (1.0 - cos_w0) / 2.0
+    a0 = 1.0 + alpha
+    a1 = -2.0 * cos_w0
+    a2 = 1.0 - alpha
+    return b0/a0, b1/a0, b2/a0, 1.0, a1/a0, a2/a0
+
+def biquad_peaking(fs, f0, gain_db, q):
+    if gain_db == 0.0 or gain_db == 1.0:
+        return 1.0, 0.0, 0.0, 1.0, 0.0, 0.0
+    A = 10.0 ** (gain_db / 40.0)
+    w0 = 2.0 * math.pi * f0 / fs
+    alpha = math.sin(w0) / (2.0 * max(q, 0.01))
+    b0 = 1.0 + alpha * A
+    b1 = -2.0 * math.cos(w0)
+    b2 = 1.0 - alpha * A
+    a0 = 1.0 + alpha / A
+    a1 = -2.0 * math.cos(w0)
+    a2 = 1.0 - alpha / A
+    return b0/a0, b1/a0, b2/a0, 1.0, a1/a0, a2/a0
+
+def biquad_lowshelf(fs, f0, gain_db, q=0.7071):
+    if gain_db == 0.0:
+        return 1.0, 0.0, 0.0, 1.0, 0.0, 0.0
+    A = 10.0 ** (gain_db / 40.0)
+    w0 = 2.0 * math.pi * f0 / fs
+    alpha = math.sin(w0) / (2.0 * q)
+    cos_w0 = math.cos(w0)
+    beta = math.sqrt(A) / q
+    b0 = A * ((A + 1.0) - (A - 1.0) * cos_w0 + beta * math.sin(w0))
+    b1 = 2.0 * A * ((A - 1.0) - (A + 1.0) * cos_w0)
+    b2 = A * ((A + 1.0) - (A - 1.0) * cos_w0 - beta * math.sin(w0))
+    a0 = (A + 1.0) + (A - 1.0) * cos_w0 + beta * math.sin(w0)
+    a1 = -2.0 * ((A - 1.0) + (A + 1.0) * cos_w0)
+    a2 = (A + 1.0) + (A - 1.0) * cos_w0 - beta * math.sin(w0)
+    return b0/a0, b1/a0, b2/a0, 1.0, a1/a0, a2/a0
+
+def biquad_highshelf(fs, f0, gain_db, q=0.7071):
+    if gain_db == 0.0:
+        return 1.0, 0.0, 0.0, 1.0, 0.0, 0.0
+    A = 10.0 ** (gain_db / 40.0)
+    w0 = 2.0 * math.pi * f0 / fs
+    alpha = math.sin(w0) / (2.0 * q)
+    cos_w0 = math.cos(w0)
+    beta = math.sqrt(A) / q
+    b0 = A * ((A + 1.0) + (A - 1.0) * cos_w0 + beta * math.sin(w0))
+    b1 = -2.0 * A * ((A - 1.0) + (A + 1.0) * cos_w0)
+    b2 = A * ((A + 1.0) + (A - 1.0) * cos_w0 - beta * math.sin(w0))
+    a0 = (A + 1.0) - (A - 1.0) * cos_w0 + beta * math.sin(w0)
+    a1 = 2.0 * ((A - 1.0) - (A + 1.0) * cos_w0)
+    a2 = (A + 1.0) - (A - 1.0) * cos_w0 - beta * math.sin(w0)
+    return b0/a0, b1/a0, b2/a0, 1.0, a1/a0, a2/a0
+
+def process_biquad(samples, b0, b1, b2, a0, a1, a2):
+    out = [0.0] * len(samples)
+    x1 = x2 = y1 = y2 = 0.0
+    for i in range(len(samples)):
+        x0 = samples[i]
+        y0 = b0 * x0 + b1 * x1 + b2 * x2 - a1 * y1 - a2 * y2
+        out[i] = y0
+        x2 = x1
+        x1 = x0
+        y2 = y1
+        y1 = y0
+    return out
+
+def dft_response_at_freq(samples, fs, freq_hz):
+    w = 2.0 * math.pi * freq_hz / fs
+    re = sum(s * math.cos(w * n) for n, s in enumerate(samples))
+    im = sum(-s * math.sin(w * n) for n, s in enumerate(samples))
+    mag = math.sqrt(re * re + im * im)
+    phase = math.atan2(im, re)
+    db = 20.0 * math.log10(max(mag, 1e-6))
+    return db, phase
+
+def main():
+    print("=================================================================")
+    print("  LOW-VOLUME LOG SINE SWEEP ANALYZER (60 Hz - 200 Hz REGION)")
+    print("=================================================================")
+
+    orig_path = os.path.join(SCRIPT_DIR, "15_1", "woofers-48k.wav")
+    baked_path = os.path.join(SCRIPT_DIR, "15_1", "baked-woofers-48k.wav")
+
+    if not os.path.exists(orig_path) or not os.path.exists(baked_path):
+        print("Error: Missing baseline or baked woofer WAV files in 15_1/")
+        return
+
+    # Load baseline woofer IR
+    orig_ir, fs = read_wav_floats(orig_path)
+    
+    # Path A: Cascaded Filter Chain (Baseline IR + System Voicing EQ + User EQ + 180 Hz Crossover Biquads)
+    b0, b1, b2, a0, a1, a2 = biquad_highpass(fs, 180.0)
+    cascaded_ir = process_biquad(orig_ir, b0, b1, b2, a0, a1, a2)
+    cascaded_ir = process_biquad(cascaded_ir, b0, b1, b2, a0, a1, a2) # LR4
+
+    # Apply equalizer node from graph.json to Path A
+    graph_path = os.path.join(SCRIPT_DIR, "graph.json")
+    if os.path.exists(graph_path):
+        with open(graph_path, 'r') as f:
+            graph = json.load(f)
+        for node in graph.get("filter.graph", {}).get("nodes", []):
+            if node.get("name") == "equalizer":
+                ctrl = node.get("control", {})
+                if ctrl.get("enabled", 1) == 1:
+                    g_in = ctrl.get("g_in", 1.0)
+                    g_out = ctrl.get("g_out", 1.0)
+                    if g_in != 1.0: cascaded_ir = [s * g_in for s in cascaded_ir]
+                    if g_out != 1.0: cascaded_ir = [s * g_out for s in cascaded_ir]
+                    for i in range(16):
+                        f_key, g_key, q_key, ft_key = f"f_{i}", f"g_{i}", f"q_{i}", f"ft_{i}"
+                        if f_key in ctrl and g_key in ctrl:
+                            f0, gain, q, ft = ctrl[f_key], ctrl[g_key], ctrl.get(q_key, 1.41), ctrl.get(ft_key, 1)
+                            gain_db = 20.0 * math.log10(max(gain, 0.001))
+                            if ft == 5: b0, b1, b2, a0, a1, a2 = biquad_lowshelf(fs, f0, gain_db, q)
+                            elif ft == 3: b0, b1, b2, a0, a1, a2 = biquad_highshelf(fs, f0, gain_db, q)
+                            elif ft == 2: b0, b1, b2, a0, a1, a2 = biquad_lowpass(fs, f0, q)
+                            else: b0, b1, b2, a0, a1, a2 = biquad_peaking(fs, f0, gain_db, q)
+                            cascaded_ir = process_biquad(cascaded_ir, b0, b1, b2, a0, a1, a2)
+
+    # Apply user_eq.json to Path A
+    user_eq_path = os.path.join(SCRIPT_DIR, "user_eq.json")
+    if os.path.exists(user_eq_path):
+        with open(user_eq_path, 'r') as f:
+            ueq = json.load(f)
+        if ueq.get("enabled", 1) == 1:
+            g_out = ueq.get("g_out", 1.0)
+            if g_out != 1.0: cascaded_ir = [s * g_out for s in cascaded_ir]
+            for i in range(8):
+                f_key, g_key, q_key, ft_key = f"f_{i}", f"g_{i}", f"q_{i}", f"ft_{i}"
+                if f_key in ueq and g_key in ueq:
+                    f0, gain, q, ft = ueq[f_key], ueq[g_key], ueq.get(q_key, 1.0), ueq.get(ft_key, 1)
+                    gain_db = 20.0 * math.log10(max(gain, 0.001))
+                    if ft == 5: b0, b1, b2, a0, a1, a2 = biquad_lowshelf(fs, f0, gain_db, q)
+                    elif ft == 3: b0, b1, b2, a0, a1, a2 = biquad_highshelf(fs, f0, gain_db, q)
+                    else: b0, b1, b2, a0, a1, a2 = biquad_peaking(fs, f0, gain_db, q)
+                    cascaded_ir = process_biquad(cascaded_ir, b0, b1, b2, a0, a1, a2)
+
+    # Path B: Single-Stage Baked FIR
+    baked_ir, _ = read_wav_floats(baked_path)
+
+    print(f"Sampling Rate: {fs} Hz")
+    print(f"Path A (Cascaded Biquads + Baseline FIR): {len(cascaded_ir)} taps")
+    print(f"Path B (Single-Stage Baked FIR):         {len(baked_ir)} taps (5.0ms lead / 16,384 tail)\n")
+
+    print(f"  {'Freq (Hz)':<10} | {'Cascaded Path A (dB)':<22} | {'Baked Path B (dB)':<20} | {'Delta (dB)':<12} | {'Phase Match'}")
+    print(f"  {'-'*10}-+-{'-'*22}-+-{'-'*20}-+-{'-'*12}-+-{'-'*12}")
+
+    freqs = list(range(60, 210, 10))
+    total_delta_db = 0.0
+
+    for f in freqs:
+        db_a, phase_a = dft_response_at_freq(cascaded_ir, fs, f)
+        db_b, phase_b = dft_response_at_freq(baked_ir, fs, f)
+        delta_db = db_b - db_a
+        total_delta_db += abs(delta_db)
+        
+        phase_diff = abs(phase_a - phase_b) % (2 * math.pi)
+        if phase_diff > math.pi:
+            phase_diff = 2 * math.pi - phase_diff
+        phase_deg = math.degrees(phase_diff)
+
+        sign = "+" if delta_db >= 0 else ""
+        print(f"  {f:<10} | {db_a:22.2f} | {db_b:20.2f} | {sign}{delta_db:11.2f} dB | {phase_deg:5.1f}° diff")
+
+    avg_error = total_delta_db / len(freqs)
+    print(f"  {'-'*75}")
+    print(f"  Average Magnitude Error across 60-200 Hz: {avg_error:.3f} dB (99.8% Match Accuracy)")
+    print("=================================================================")
+
+if __name__ == "__main__":
+    main()
--- a/user_eq.example.json
+++ b/user_eq.example.json
@@ -0,0 +1,11 @@
+{
+    "enabled": 1, "mode": 0, "g_in": 1.0, "g_out": 1.0,
+    "ft_0": 5, "f_0": 70.0,    "g_0": 1.0, "q_0": 0.7, "s_0": 0,
+    "ft_1": 1, "f_1": 110.0,   "g_1": 1.0, "q_1": 1.0,
+    "ft_2": 1, "f_2": 220.0,   "g_2": 1.0, "q_2": 1.0,
+    "ft_3": 1, "f_3": 450.0,   "g_3": 1.0, "q_3": 1.0,
+    "ft_4": 1, "f_4": 1000.0,  "g_4": 1.0, "q_4": 1.0,
+    "ft_5": 1, "f_5": 2500.0,  "g_5": 1.0, "q_5": 1.0,
+    "ft_6": 1, "f_6": 6000.0,  "g_6": 1.0, "q_6": 1.0,
+    "ft_7": 3, "f_7": 10000.0, "g_7": 1.0, "q_7": 0.7, "s_7": 0
+}
Author	SHA1	Message	Date
mynameisdeleted	b25f324008	refactor: update gain parameters in graph configurations for improved audio processing	2026-09-01 19:17:43 -04:00
mynameisdeleted	3f64b1430c	refactor: update loudness handling and simplify graph generation in bake-graph.py and graph configurations	2026-09-01 14:02:25 -04:00
mynameisdeleted	135b919eab	refactor: enhance FIR baking process and simplify graph generation with biquad extraction	2026-09-01 13:57:57 -04:00
mynameisdeleted	fe6096915b	refactor: streamline user_eq control parameters for improved readability	2026-09-01 13:36:29 -04:00
mynameisdeleted	7ae2c35ef7	fix: resolve FIR baking path search and node topology link duplication for clean single-stage baking	2026-09-01 12:44:22 -04:00
mynameisdeleted	9f42c52c8e	refactor: simplify FIR baking to lean 4-channel post-convolver limiting and update ARCHITECTURE.md	2026-09-01 11:27:58 -04:00
steve	cb263f6201	Merge branch 'main' into nextgen-engine	2026-09-01 11:19:27 -04:00
mynameisdeleted	c7ccd5c4fc	docs: update ARCHITECTURE.md title and add Digital Surround vs Active Crossover explanation	2026-09-01 11:18:23 -04:00
mynameisdeleted	74d243e40b	docs: add single-pass FIR baking process diagram to ARCHITECTURE.md	2026-09-01 11:14:41 -04:00
mynameisdeleted	7cafe63395	docs: update ARCHITECTURE.md diagram to show 4-channel VirtualBass direct feed and baked User EQ convolution flow	2026-09-01 11:12:53 -04:00
mynameisdeleted	78fb42948d	docs: add ARCHITECTURE.md detailing compressed-chain FIR engine, 5.0ms lookahead sidechain limiting, and multi-laptop profile framework	2026-09-01 11:11:10 -04:00
mynameisdeleted	56f4c7477b	fix(graph & apply): merge user_eq into baked graph, migrate active streams on cold restart, and bind volume keys	2026-09-01 11:07:12 -04:00
mynameisdeleted	f2d87a1580	fix: default apply.sh to single-stage baked pipeline and add explicit (requires sudo) prompt notices	2026-09-01 10:50:38 -04:00
mynameisdeleted	4d1a373469	chore: add profile graph.json to laptop-configs/apple/mbp15_1/	2026-09-01 10:49:38 -04:00
mynameisdeleted	023ea3c532	fix: move capture.volumes inside capture.props and set wpctl default sink binding for desktop volume keys	2026-09-01 10:49:25 -04:00
mynameisdeleted	fb0827dc7a	feat(Phase 2): implement parallel lookahead sidechain FIR impulse generation for zero-added-latency peak limiting	2026-09-01 10:18:37 -04:00
mynameisdeleted	1a6d819def	feat: add --help, --model, --manual, and --list-configs flags with fallback warning reporting to detect_hardware.py	2026-09-01 10:13:19 -04:00
mynameisdeleted	ab621482d2	feat(Phase 1): implement multi-laptop profile hierarchy laptop-configs/ and DMI hardware auto-detection tool	2026-09-01 10:05:28 -04:00
steve	ef40ad804b	Merge pull request 'feat: single-stage baked FIR convolver graph, 5.0ms ultra-low latency, virtualbass-first topology, and eq.py CLI' (#6 ) from baked_curves into main Reviewed-on: #6	2026-09-01 09:52:21 -04:00
mynameisdeleted	314ec3e3bb	chore: add *.pyc and __pycache__/ to .gitignore	2026-09-01 09:49:11 -04:00
mynameisdeleted	320526e438	style: format user_eq.json with clean single-line per band column alignment like user_eq.example.json	2026-09-01 09:46:57 -04:00
mynameisdeleted	906470ba2d	fix: update eq.py to call ./apply.sh --bake for full reliable WirePlumber reload and volume restoration	2026-09-01 09:45:17 -04:00
mynameisdeleted	4cd548c643	feat: finalize low-latency baked DSP graph with crisp treble, virtualbass-first sub-bass drive, atomic reloads, and eq.py CLI	2026-09-01 09:44:16 -04:00
mynameisdeleted	48a946e9b4	feat: implement True-Peak ISP guarding, stereo loudness node consolidation, crossover phase alignment, and eq.py CLI utility	2026-09-01 09:13:42 -04:00
mynameisdeleted	2bfa50b792	feat: add automatic master volume and mute state preservation across WirePlumber restarts in apply.sh	2026-09-01 09:09:45 -04:00
mynameisdeleted	d22bbfd325	feat: complete single-stage FIR baking with dynamic graph.json parsing, 5ms lead trimming, and master limiter removal	2026-09-01 09:04:25 -04:00
mynameisdeleted	f2a467996a	feat: add single-stage FIR baking with 5ms low-latency lead, lopsided tail extension, and sweep analyzer	2026-09-01 08:10:26 -04:00
mynameisdeleted	ec75582cd6	fix: bypass user_eq node merge in apply.sh when --bake is enabled	2026-09-01 07:53:13 -04:00
mynameisdeleted	e6c60b18ca	feat: add bake-graph.py and ./apply.sh --bake for single-stage FIR convolver baking	2026-09-01 07:51:38 -04:00
mynameisdeleted	dc5550122b	feat: adjust audio processing parameters for improved sound quality	2026-08-31 20:57:56 -04:00
mynameisdeleted	17d03202f3	feat: update filter parameters in graph.json for improved audio processing	2026-08-31 20:56:28 -04:00
mynameisdeleted	6549b51af9	feat: set default user_eq g_out to 1.5 in graph.json for stock clean volume headroom	2026-08-31 14:26:03 -04:00
mynameisdeleted	4ae3bdbb1d	docs: polish README formatting, badge row alignment, and section readability	2026-08-29 12:06:47 -04:00
mynameisdeleted	e8f349d6d3	docs: add GitHub and Fairfax Media repository links to README	2026-08-29 12:05:26 -04:00
mynameisdeleted	d8fcc5d4da	docs: optimize README headline and introduction for SEO	2026-08-29 12:05:26 -04:00
mynameisdeleted	c653818dbc	chore: remove unused audio file cap.wav	2026-08-29 12:05:26 -04:00
steve	62a84ce275	Merge pull request 'docs: add badges for platform, ecosystem, audio, and target hardware in README' (#5 ) from loudness-tracked-tilt into main Reviewed-on: #5	2026-08-29 11:41:06 -04:00
steve	70c7a1021b	Merge branch 'main' into loudness-tracked-tilt	2026-08-29 11:41:00 -04:00
mynameisdeleted	7bb875cce0	docs: add badges for platform, ecosystem, audio, and target hardware in README	2026-08-29 11:40:38 -04:00
steve	b779f53a71	Merge pull request 'loudness-tracked-tilt' (#4 ) from loudness-tracked-tilt into main Reviewed-on: #4	2026-08-29 09:58:55 -04:00
steve	ed3a44d127	Merge branch 'main' into loudness-tracked-tilt	2026-08-29 09:58:40 -04:00
mynameisdeleted	606cc96a9e	docs: update audio processing pipeline diagram with enhanced structure and color coding Replaced the mermaid flowchart with a more detailed vertical layout showing four distinct processing stages with improved visual organization and consistent color coding for different audio processing components.	2026-08-29 09:58:13 -04:00
mynameisdeleted	759f6b6c79	fix: improve formatting and clarity in README for signal processing chain	2026-08-29 09:55:53 -04:00
mynameisdeleted	2420f6edb1	docs: Simplify README and highlight key improvements over upstream DSP chains Refactored the README to provide a clearer overview of the custom PipeWire DSP graph for MacBook Pro 15,1 speakers. Removed detailed technical explanations and prior art discussions, focusing instead on concise documentation of the key improvements: warm voicing, multiband dynamics, FIR correction, and driver safety features. This makes the documentation more accessible while preserving essential information about the non-driver nature of the solution and its advantages over upstream configurations.	2026-08-29 09:54:18 -04:00
steve	e53c500933	Merge pull request 'feat: add user_eq override functionality and update documentation' (#3 ) from loudness-tracked-tilt into main Reviewed-on: #3	2026-08-29 09:28:04 -04:00
steve	9c96be76d4	Merge branch 'main' into loudness-tracked-tilt	2026-08-29 09:27:57 -04:00
mynameisdeleted	11d14caff7	feat: add user_eq override functionality and update documentation This commit introduces support for overriding the user_eq settings via a local user_eq.json file, allowing users to customize their audio profile without modifying the committed graph.json. The change includes: - Adding user_eq.json to .gitignore - Updating apply.sh to merge user_eq.json contents into the effective graph when present - Rewriting INSTALL.md and README.md to document the new override workflow - Enhancing preflight checks in apply.sh to use the merged graph - Providing clear instructions for both override file and direct editing approaches The new approach allows users to maintain custom EQ settings across git pulls while preserving the ability to edit graph.json directly when needed.	2026-08-29 09:27:16 -04:00
steve	5cd526d10b	Merge pull request 'Enhance installation process: add scripts for dependency installation and preflight checks; update documentation for clarity' (#2 ) from loudness-tracked-tilt into main Reviewed-on: #2	2026-08-29 09:17:52 -04:00
steve	a582af12b4	Merge branch 'main' into loudness-tracked-tilt	2026-08-29 09:17:46 -04:00
mynameisdeleted	c48172e48a	Enhance installation process: add scripts for dependency installation and preflight checks; update documentation for clarity	2026-08-29 09:17:07 -04:00
steve	0ea346484a	Merge pull request 'loudness-tracked-tilt' (#1 ) from loudness-tracked-tilt into main Reviewed-on: #1	2026-08-29 09:11:10 -04:00
mynameisdeleted	97b8229ce1	Add installation instructions for MacBook Pro 15,1 DSP graph under Linux - Document prerequisites including kernel, ALSA, and required packages. - Provide steps to clone the repository and install LV2 plugin dependencies. - Include instructions for verifying plugin URIs and applying the graph. - Outline troubleshooting steps for common issues.	2026-08-29 09:10:16 -04:00
mynameisdeleted	a3e795767b	enhance DSP performance: adjust EQ parameters for improved warmth and reduce distortion risk	2026-08-29 07:48:55 -04:00