IAMCCS Cine Shot Line Builder
Write one cinematic shot, get a prompt-worthy line for the multigen
- shot_line
- shot_prompt
- reference_token
- report
If the shotboard planners are for single continuous shots, Shot Line Builder is for the other approach: generating each shot as its own piece and assembling a scene from pieces. This is the node that writes one shot's worth of direction - framing, subject, action, dialogue, camera, lighting - and turns it into a structured "shot line" that a multi-generation director can stack with its siblings. The defaults even read like a scene: "Mara," "medium close-up," "near the kitchen window, she speaks softly but firmly," "You left the city without saying goodbye." The author clearly built this while writing dialogue scenes.
How it works. You describe the shot through a row of discrete fields, and the node composes them into two outputs: shot_line (the machine-readable line for the multigen pipeline) and shot_prompt (the human-readable prompt that expresses the whole shot). The reference_token output identifies which reference image the shot should use, and report dumps the composition for debugging.
The inputs that matter. The full list is long, but they're all fields you actually understand:
cut_mode-hard_cut,continuity_cut,soft_cut, ormatch_cut. How this shot joins the last one.framing- a ten-way dropdown from "wide establishing shot" down to "insert detail" and "two-shot," pluscustom.subjectandaction_prompt- who's in the frame and what they're doing.dialogue_textandvoice_direction- what they say and how (this feeds the audio/lipsync side of LTX-2.3).camera_movementandlighting- dropdowns with acustomescape hatch each.reference_modeand theprimary_reference_index/secondary_reference_index- which references the shot anchors on (single,start_to_end, ordual).audio_index- which audio line the shot is synced to.continuity_note- free-form consistency reminders ("keep coherent eyelines and stable character identity").duration_seconds- defaults to 4, the classic shot length.
Two optional overrides: prompt_override (per its tooltip, if connected or filled it replaces the dropdown-composed shot prompt entirely) and extra_prompt (appends extra text).
Where it fits. Build shots with this node, then feed their shot_line outputs into the pack's multigen director/line-stacker nodes (the IAMCCS_CineLineStacker / multi-generation side of the family) to sequence a whole scene. It's the "write one shot" atom of the multi-generation workflow, the same way the planners are the "write one continuous shot" atom.
Install. Pack-wide: ComfyUI Manager (search "IAMCCS"), or git clone https://github.com/IAMCCS/IAMCCS-nodes into custom_nodes, restart. Pure prompt-composition logic - no models, no VRAM, no LTX stack required just to use it.
Gotchas. The defaults are a temptation: the dropdowns have custom options, and the prompt_override tooltip is explicit that filling it bypasses the whole composition. If your shots keep coming out generic, you're probably leaning on the defaults instead of writing the action_prompt/dialogue_text/continuity_note fields. And remember the prompt-sensitivity reality of LTX-2.3: it rewards specific, detailed prompts, so a half-empty shot line will produce a half-committed shot. Fill in the fields.
Inputs (17)
| Name | Type | Default | Description |
|---|---|---|---|
| duration_seconds | FLOAT | 4.000.01–3600 | — |
| cut_mode | COMBO | hard_cut | 4 options: hard_cut, continuity_cut, soft_cut, match_cut |
| primary_reference_index | INT | 11–8 | — |
| reference_mode | COMBO | single | 3 options: single, start_to_end, dual |
| secondary_reference_index | INT | 00–8 | — |
| audio_index | INT | 10–8 | — |
| label | STRING | campo_mara | — |
| framing | COMBO | medium close-up | 10 options: custom, wide establishing shot, medium shot, medium close-up, close-up, extreme close-up, +4 |
| subject | STRING | Mara | — |
| action_prompt | STRING | near the kitchen window, she speaks softly but firmly | — |
| dialogue_text | STRING | You left the city without saying goodbye. | — |
| voice_direction | STRING | controlled hurt voice | — |
| camera_movement | COMBO | subtle handheld | 7 options: custom, locked-off camera, slow push-in, slow pull-back, subtle handheld, gentle pan, +1 |
| lighting | COMBO | rainy night reflections | 7 options: custom, soft window light, warm practical lamps, noir desk lamp, moonlight through window, rainy night reflections, +1 |
| continuity_note | STRING | keep coherent eyelines and stable character identity | — |
| prompt_overrideopt | STRING | If connected or filled, this replaces the dropdown-composed shot prompt. | |
| extra_promptopt | STRING | — |
Outputs (4)
| Name | Type | Description |
|---|---|---|
| shot_line | STRING | — |
| shot_prompt | STRING | — |
| reference_token | STRING | — |
| report | STRING | — |