
How cuts are detected
Two signals are blended:- Pixel-level scene scores from the footage itself catch hard cuts precisely.
- Per-frame subject changes from the Blueprint catch the soft transitions that pixel-diffing misses — common in AI-generated montages where shots dissolve into each other.
What each cut contains
| Field | What it holds |
|---|---|
name | A technique-focused title — the production move, not the on-screen subject (e.g. “Lateral Tracking Corridor Walk”) |
description | What’s in the shot |
start_ts / end_ts / duration_seconds | Real timing, read from the footage |
clip_url | The shot as a streamable MP4, with audio, up to 1080p |
frame_urls | First frame + up to 5 real in-shot frames + last frame |
tags | Technique tags for scanning the grid |
directors_brief | On demand: how_they_did_it, agent_instructions, use_cases, difficulty, animation_notes |
recreation_prompts | On demand: a group_prompt plus per_frame entries (recreation_prompt, camera, transition_to_next) — see Recreation |
Exports
From the app’s Cuts tab you can download:- Recipe
.md— the full cut list as a markdown brief you can hand to an editor or an agent - All cuts (ZIP) — every clip as a file
What to do with it
- Build your shot list from the cut titles. The technique names are deliberately topic-agnostic — “Symmetrical Family Portrait Composition” works for any subject. Your shot list is the titles, in order, with your content poured in.
- Time your edit against the durations. If the reference holds establishing shots for 2 seconds and reaction shots for 1, those numbers transfer directly to your timeline.
- Watch the first and last frames of each cut to understand the transitions — what image the editor cut from and to is usually the trick.
- Reference, don’t copy. The clips exist so you can study the technique; the recreation layer turns each technique into prompts for building your own footage.
Related layers
The Blueprint
The aggregate stats these shots roll up into.
Recreation
Per-cut recipes and prompts for rebuilding each technique.
Sound layer
What the audio is doing during each of these shots.
Cast
The recurring people, places, and props these cuts are made of.