Skip to content

Commit 2e2b5c8

Browse files
vanceingallsclaude
andcommitted
feat(hyperframes-audio): default the voiceover carve strength to 0.8
0.25 left the bed audibly fighting the voice; a build carved at 0.25 had to be redone at 0.8 before it was accepted. Make carve.mjs default to 0.8 and rewrite the strength prose and the sample output to match. The core DEFAULT_CARVE used by the Studio panel is unchanged. Co-Authored-By: Claude Fable 5.1 <[email protected]>
1 parent 0b9852f commit 2e2b5c8

3 files changed

Lines changed: 18 additions & 19 deletions

File tree

‎skills-manifest.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@
2626
"files": 121
2727
},
2828
"hyperframes-audio": {
29-
"hash": "d893452e066a0c38",
29+
"hash": "24871fc8a76d942f",
3030
"files": 7
3131
},
3232
"hyperframes-cli": {

‎skills/hyperframes-audio/SKILL.md‎

Lines changed: 15 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -221,8 +221,8 @@ where it can actually act as a ceiling.
221221
**Required whenever music plays under a voice.** If a composition places a
222222
music bed (BGM) under any voice track — narration, avatar speech, interview,
223223
voiceover — carving the bed is part of finishing the mix, not an optional polish.
224-
Run `node <SKILL_DIR>/scripts/carve.mjs --comp <file.html>` (add `--bed` /
225-
`--voice` when detection picks wrong), confirm the written `data-fx-carve`,
224+
Run `node <SKILL_DIR>/scripts/carve.mjs --comp <file.html>` (default strength
225+
`0.8`; add `--bed` / `--voice` when detection picks wrong), confirm the written `data-fx-carve`,
226226
`data-fx-chain` and `data-automation` with `npx hyperframes check`, and only then
227227
render. A volume duck on its own is not a finished mix: it leaves the voice and
228228
the bed fighting in the 1–3 kHz band and costs the bed all of its presence for the
@@ -262,11 +262,7 @@ analysis time, so a clip added to the group later is covered without touching
262262
<audio id="vo-middle" data-audio-group="voiceover" …></audio>
263263
<audio id="vo-outro" data-audio-group="voiceover" …></audio>
264264

265-
<audio
266-
id="music"
267-
data-fx-carve='{"enabled":true,"sources":["voiceover"],"strength":0.25}'
268-
…
269-
></audio>
265+
<audio id="music" data-fx-carve='{"enabled":true,"sources":["voiceover"],"strength":0.8}' …></audio>
270266
```
271267

272268
A `sources` list naming two or more plain clip ids instead of a group is caught
@@ -365,12 +361,15 @@ many bands, how wide, how far to favour intelligibility over raw voice energy,
365361
how far the level may drop, how far under the voice to aim. Those six move
366362
together in any real mix — a gentle carve is a shallow cut in few bands with
367363
little ducking, a hard one is deeper in more bands with more — so they are one
368-
relationship written once, in `carveProfile`. Default is `0.25` — a 6 dB dip in
369-
three bands with 6 dB of level room, audible without sounding like a hole. At
370-
`0.5` the dip reaches 10 dB, which is where a carve starts being heard as an
371-
effect rather than as room for the voice; above that is deliberate territory for
372-
a loud bed under a quiet voice. `0` is spectral only — one band, no level match
373-
at all.
364+
relationship written once, in `carveProfile`. `carve.mjs` defaults to `0.8` —
365+
six bands from 250 Hz to 2.5 kHz cut about 7 dB each and 15 dB at 1.6 kHz, with
366+
19 dB of level room — because a bed under narration has to get out of the way
367+
first and be music second; `0.25` (a 6 dB dip in three bands, 6 dB of room) kept
368+
the bed present but still let it fight the voice, and was judged too weak in
369+
practice. At `0.5` the dip reaches 10 dB, which is where a carve starts being
370+
heard as an effect rather than as room for the voice. Drop the strength when the
371+
bed is the point and the voice is sparse. `0` is spectral only — one band, no
372+
level match at all.
374373

375374
**Carve by default.** A bed playing under narration wants a carve; it is not a
376375
polish step to get to if there is time. Place both tracks, run the command below,
@@ -409,9 +408,9 @@ dynamically at the default strength, and prints what it decided:
409408
```
410409
bed music-bed (name looks like music)
411410
voice narration (only track left)
412-
carve strength 0.25 dynamic
413-
bands 400Hz -6dB q1.4, 1000Hz -3dB q1.4, 1600Hz -3.17dB q1.4
414-
level 216-point envelope, floor -6 dB
411+
carve strength 0.8 dynamic
412+
bands 250Hz -7.4dB q2.06, 400Hz -7.4dB q2.06, 630Hz -7.4dB q2.06, 1000Hz -7.4dB q2.06, 1600Hz -14.8dB q2.06, 2500Hz -7.4dB q2.06
413+
level 273-point envelope, floor -19.2 dB
415414
```
416415

417416
Name the tracks with `--bed` / `--voice` (repeatable) when the automatic choice is

‎skills/hyperframes-audio/scripts/carve.mjs‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,12 +39,12 @@ const usage = `carve.mjs --comp <file.html> [--bed <elementId>] [--voice <elemen
3939
4040
--bed id of the music track that gets carved (detected if omitted)
4141
--voice id of a voice to make room for; repeatable (detected if omitted)
42-
--strength how hard to carve, 0..1 (default 0.25)
42+
--strength how hard to carve, 0..1 (default 0.8)
4343
--dry-run report what it would write, touch nothing
4444
--core directory to resolve @hyperframes/core from (default: the comp's)`;
4545

4646
function parseArgs(argv) {
47-
const args = { strength: 0.25, dryRun: false, voices: [] };
47+
const args = { strength: 0.8, dryRun: false, voices: [] };
4848
for (let i = 0; i < argv.length; i += 1) {
4949
const flag = argv[i];
5050
const next = () => {

0 commit comments

Comments
 (0)