Files
bass-foundry/docs/ballast/CHANGELOG.md
T
nvrl d93dd942a8 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.
2026-11-06 16:05:19 +01:00

898 B

Ballast changelog

Unreleased (0.1.0)

  • Introduce Ballast, a switch-up leveller: every part of a bassline gets one gain that brings it to the Target loudness. No compression inside a part.
  • Parts start at note starts (detected from the audio, or from MIDI) or on the host's beat grid, from 1 bar to 1/16.
  • Loudness is K-weighted (ITU-R BS.1770) over each part's first 100 ms, in 10 ms blocks with a relative gate, and each part is weighted from rest.
  • The gain glides over 5 ms and is in place on the part's first sample.
  • Learn takes the next part's loudness as the target. Amount, Range, Measure from (leave the sub out of the measurement), Gate, Output, Bypass.
  • Editor: the last 32 parts, their loudness in and out, the target, and the spread of the last 16 parts.
  • About 172 ms of latency: the tracker's lookahead, the window and the glide.