Skip to content

tts: say plainly that this is a dubbing default, not a narration one - #52

Merged
thorwhalen merged 1 commit into
mainfrom
narration-vs-dubbing-defaults
Sep 17, 2026
Merged

thorwhalen merged 1 commit into
mainfrom
narration-vs-dubbing-defaults

Conversation

@thorwhalen

Copy link
Copy Markdown
Collaborator

mixing.text_to_speech is public and general-purpose, and its defaults are eleven_multilingual_v2 at stability 0.5.

For dubbing that is correct and stays unchanged: a dub tracks a performance that already exists, the timing is fixed by the source, the delivery belongs to the original actor, and per-take variance is a defect rather than life.

For narration it is the wrong default, because v2 cannot render inline [audio tags] at all — and tag density is the single biggest lever on whether a read sounds alive (measured: plain text 70.8 Hz of pitch range, the same sentence densely tagged 124.4 Hz; stability across its entire range moves it only 85 → 72 Hz). A narration built on this default is capped at the flat end before an author writes a word. One such render came back from a listener as somniferous.

Flipping the default would regress dubbing, so it stays. What changes is that the docstrings now name the split and send narration/commentary work to braidio, which owns expressive delivery and now defaults to eleven_v3 (braidio#71).

Docstrings only; no behaviour change. Suite 500 passed.

mixing.text_to_speech is public and general-purpose, and its defaults are
eleven_multilingual_v2 at stability 0.5. For DUBBING that is right: a dub tracks
a performance that already exists, the timing is fixed by the source, and
per-take variance is a defect rather than life.

For NARRATION it is the wrong default, because v2 cannot render inline
[audio tags] at all — and tag density is the main lever on whether a read
sounds alive (plain text 70.8 Hz of pitch range, densely tagged 124.4 Hz). A
narration built on this default is capped at the flat end before a word is
written; one such render came back from a listener as 'somniferous'.

So the defaults stay (flipping them would regress dubbing) and the docstrings
now name the split and point narration work at braidio, which owns expressive
delivery and defaults to eleven_v3.

Docstrings only; no behaviour change. Suite 500 passed.
@thorwhalen
thorwhalen merged commit c27b4ab into main Sep 17, 2026
12 checks passed
@thorwhalen
thorwhalen deleted the narration-vs-dubbing-defaults branch September 17, 2026 08:21
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