feat(ballast): add Ballast switch-up leveller

Ballast gives every part of a bassline one gain that brings it to the target
loudness, with no compression inside a part. Parts start at note starts,
detected from the audio or taken from MIDI, or on the host's beat grid, so a
patch change on the same note counts too.

- Loudness is K-weighted over each part's first 100 ms, in 10 ms blocks with
  a relative gate, and every part is weighted from rest so the last part does
  not ring into it.
- The audio path is delayed by the tracker's lookahead, the window and a
  5 ms glide, so each gain is in place on its part's first sample.
- Learn takes the next part's loudness as the target. Amount, Range, Measure
  from (leave the sub out), Gate, Output, Bypass.
- Editor shows the last 32 parts in and out, the target, and the spread of
  the last 16 parts.
- Registered in the catalog, workflows, editor-check, README, chain and
  development docs, and the website copy.
This commit is contained in:
nvrl committed 2026-11-06 16:05:19 +01:00
1 parent d77b88c7a9
commit d93dd942a8
28 files changed
+4716 -21

No files matched your search

+17 -2
View File
@@ -263,8 +263,8 @@ one period of the note, so heavy settings do not ripple at f0. See [Planish](pla
Patina already cut fixed formants on every note, but it also cut a boosted
harmonic as hard (5.7 dB), at a position that moved with the note.
Open: MIDI as the pitch source.
3. Planish (done, released 0.1.0), then Quench (done, unreleased) and Ballast:
they fill the mix and master gap.
3. Planish (done, released 0.1.0), then Quench and Ballast (both done,
unreleased): they fill the mix and master gap.
- In parallel, from the research findings, in this order: Weld delay
spread (done, Weld 0.3.0); the fatness lane, as the first Assay piece
(prototype `scripts/fatness.py`); Anvil Ghost harmonics and Phone listen
@@ -376,6 +376,21 @@ the same loudness without compression changing its character. Earlier working
name: Hit Leveler. Pairs with Anvil: Anvil levels the sub, Ballast the whole
patch.
Built (unreleased 0.1.0, see [Ballast](ballast/README.md)): one gain per part,
parts from note starts or the host grid (a patch change on the same note is not
a new note to the tracker), K-weighted loudness of the first 100 ms, Learn for
the reference. Found while building it:
- A note start from a pitch change comes about 20 ms early, in the gap before
the note; a plain mean over the window then reads the part ~0.9 dB quiet.
Fixed with 10 ms blocks and a relative gate (−20 dB under the loudest block).
- The K-weighting filters ring the last part into the next one: a near-silent
part after a loud one read −18 LUFS instead of under −60. Fixed by weighting
every part from rest.
- Next ideas: a brightness match next to loudness (problem 2 names both; with
Lathe or Patina doing the EQ), a "follow" option for long notes that swell,
and switch-up detection from timbre change instead of the grid.
### Bellows — pitch-tracked resonator
A comb or Karplus-style resonator tuned to the detected note. It turns noise,