version: "1.0.0" name: vlog-pacing description: The numbers and rules that make a transcript-based cut feel natural instead of "popping" - silence detection, word pads, pause shortening, room at scene edges, jump-cut zoom alternation and punch-ins. Use when building the cut planner, tuning pauses, or when the creator says the edit is too choppy or too slow.

Pacing: how much air to leave

A transcript cut is precise; the danger is that it is too precise. Every cut becomes a jump cut and the video "pops". These values came from real feedback.

Cut from the transcript, never from volume

A volume-only silence cut (ffmpeg silencedetect on the whole file) gave ~800 choppy pieces on a 34-minute class. Cutting from the word timestamps gave 120 pieces the creator loved. Use the waveform only to refine edges.

Planner algorithm (in words)

1. Silence map per clip: below -43 dB for at least 0.25 s.
2. Pause candidates inside kept speech: gap between two words ≥ 0.25 s and ≥ 85% of it is silence on the waveform (an untranscribed sound is not a pause).
3. Shorten only pauses longer than max_pause, down to pause_keep. Split the leftover air 40% before / 60% after.
4. Word edges: start = word start − 0.08 s, end = word end + 0.12 s, refined to the nearest silence edge within 0.25 / 0.3 s so soft consonants aren't clipped; never reach into a word that was cut.
5. Scene edges: the first range of a clip gets 0.5 s before the first word, the last range 0.6 s after the last word (only spoken words limit this; a lighter click or ambience may stay). Override per range in the keep-list (lead_in, tail). Look at frames first: stop before the creator reaches for the camera.
6. Snap to frames (start floors, end ceils, end exclusive), remove overlaps, merge touching pieces.
7. Write a review file: the transcript with cut words struck through + a timeline list with times.

Settings that worked

Rough check with a pause report ("what if max_pause = …: N cuts, saves X s") before choosing. On a dramatic slow opening, 0.5 s gave 7 jump cuts in 20 seconds; 1.0 s gave 3 in 53 seconds.

Framing (zoom)

• Every jump cut inside one scene alternates 100% / 107.5%, so it reads as a camera change.
• A new scene (new clip, or after B-roll) always opens at 100%. Toggling zoom on scene changes adds pops.
• Punch-in 115% only for the punchline itself: split the piece at the line's first word and again right after its last word. Without the second split one punch-in held 83 seconds.
• B-roll is always 100%.

When they say "it's choppy"

Measure first (how many cuts come from pause shortening vs. scene edges vs. zoom), then fix the actual cause: usually loosen pauses, add scene room, and stop zooming on scene changes. Don't guess.