Fast camera rules (R1–R12)
Practitioner consensus (Shortzly, Splice, ClickyApps, Zella), not peer-reviewed studies. Fast is a TEST — validate by A/B before locking in. The old slow system (V1.1: median shot ~17 s, ~0.4 cuts/10 s, camera at rest 30%+) was removed in V1.2.1.
| # | Rule | Number | Enforced by |
|---|---|---|---|
| R1 | Max shot length 6 s, except one whitelisted contrast beat | 6 s | pace_check.py, film_plan.py |
| R2 | Target ASL 2.5–4 s; ≥10 visual changes per 60 s (target 12–20) | ASL 2.5–4 s | pace_check.py, film_plan.py |
| R3 | Camera moving ≥90% of frames; no rest over 0.5 s outside a whitelisted beat | ≥90%, rest ≤0.5 s | film_plan.py |
| R4 | Every narration line maps to ≥1 visual (scene change, insert, prop gag, caption change, zoom punch); a line with no visual is rewritten | 1 visual / line | pace_check.py |
| R5 | Hook: first visual change within 2 s, first question/open loop within 3 s | ≤2 s / ≤3 s | pace_check.py |
| R6 | Vary rhythm: ≤3 consecutive shots at the same length; fast cuts at high energy, 4–6 s for emotional/complex beats | ≤3 in a row | pace_check.py |
| R7 | Sound: ≤6 SFX per 60 s (target 3), structural cuts only; SFX ≤−6 dB vs speech; whoosh peak exactly on the split; never over spoken words | ≤6, −6 dB | audio-mix check (manual) |
| R8 | Captions: every line captioned; keyword pop on punch word; anim 0.2–0.5 s; ~3 words/s | 0.2–0.5 s | caption track |
| R9 | No cut mid-sentence; cuts land on pauses or on the punch word | 0 mid-sentence cuts | pace_check.py |
| R10 | One deliberate slow/contrast beat per Short (0.5–1 s hold after the key line, or one 4–6 s slower shot), whitelisted | 1 per Short | pace_check.py, film_plan.py |
| R11 | Audit every render with PySceneDetect (AdaptiveDetector): report ASL, cuts/10 s, longest shot; fail if R1/R2 breached | — | WORKFLOW step 10 |
| R12 | A/B before locking in: the fast cut must beat the archived V1.1 slow cut of the same story on retention/views | — | process, not a tool |
Fast vocabulary
- Push-in per beat — a short push-in on every narration line; the camera never sits still.
- Whip pan + match cut — a fast pan that hides the cut.
- Crash zoom / FOV kick — a sudden focal-length punch on the punch word (≥15% lens change).
- Tracking / orbit — the camera trucks or orbits round the subject through the line.
- Handheld shake — a small continuous shake layer so no frame reads dead still.
- Speed ramps — travels run at constant (linear snap) speed; landings hidden by cuts or the punch word.
- Foreground wipes — a near object sweeps across the lens to hide a cut.
Fast cutting HURTS when: the cut carries no new information, it lands mid-sentence, or the rhythm is monotone.
How the tools enforce pace
python tools/film_plan.py check episodes/<name>/film.json python tools/pace_check.py check episodes/<name>/film.json [--script two-column.md] # R11 audit (PySceneDetect, install once on the PC): pip install scenedetect scenedetect -i film.mp4 detect-adaptive list-scenes