Skip to content

Add phrase-safe dialogue leveller and preserve Foley silence boundaries - #1

Draft
lobsterclause wants to merge 2 commits into
mainfrom
feat/dialogue-leveller
Draft

lobsterclause wants to merge 2 commits into
mainfrom
feat/dialogue-leveller

Conversation

@lobsterclause

Copy link
Copy Markdown
Contributor

Summary

  • Add experimental offline dialogue levelling from explicit word timings, linked mono/stereo gains, conservative gain/headroom limits, breath keep/attenuate policy, and JSON audit reports.
  • Keep gain constant across words and require full configured pause ramps; skip unsafe transitions instead of shortening them silently.
  • Add CLI, timing schema and method/default documentation.
  • Separately fix an existing Foley floating-point duration overshoot at designed silence boundaries using the existing texture directed-rounding pattern.

Verification

  • make verify: 170 tests passed on Linux/Python 3.12.
  • 23 focused leveller tests cover convergence, unchanged samples, timing validation, breath policy, clipping guards and pause adequacy.
  • Foley property tests plus deterministic boundary regression: 4 passed.
  • git diff --check passed.

Limits / review needed

  • Explicit word timings only; no VAD, transcription or model downloads.
  • Ungated K-weighted phrase measurement, not standardized EBU short-term loudness.
  • Sample-peak protection, not a true-peak limiter; QC and listening review remain necessary.
  • No production recordings or listening validation used. Draft for review, not a release.

Use explicit word timings, phrase-constant gains and full pause-only ramps. Preserve unchanged regions and skip rides when a safe ramp cannot fit. Document engineering defaults and metric limitations; cover behavior with synthetic tests.
Match the existing texture directed-rounding guard so floating-point duration reconstruction cannot cross a silence boundary. Pin the discovered property-test counterexample with a deterministic regression.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant