Nodes/Director-Package-ComfyUI/TV Wan Shot Iterator 🎬
ComfyUI Node

TV Wan Shot Iterator 🎬

The tiny node that makes Wan shot loops work

By TensorVizionΒ·Created 23 days agoΒ·Updated 23 days agoΒ· 1
TV Wan Shot Iterator 🎬
  • wan_shots
  • positive
  • negative
  • latent
  • num_frames
  • shot_id
β—„index0β–Ί

TV Wan Shot Iterator 🎬 is the most boring node in the Director pack, and that's exactly what makes it useful. The Wan and Hunyuan adapters don't hand you one conditioning object you can sample - they hand you a list of per-shot bundles, because those models condition per-clip. This node is the pull-one-off-the-stack step: give it the shot list and an index, and it returns that single shot's positive, negative, latent, and frame count, ready to feed a sampler.

You reach for it whenever you're looping a TV_WAN_SHOTLIST. The pattern looks like this: TV Director β†’ TV β†’ Wan Adapter β†’ this node (with an index that advances each pass) β†’ KSampler β†’ collect the results β†’ a video-combine node stitches the shots in timeline order. It also works on the Hunyuan adapter's output unchanged, since both emit the same TV_WAN_SHOTLIST schema - one iterator, two backends.

Inputs and outputs that matter

Two inputs, both required:

  • wan_shots - the shot list from TV β†’ Wan Adapter or TV β†’ Hunyuan Adapter.
  • index - which shot to pull, 0-based, default 0, max 4096. In a loop this is the counter you increment each pass.

Outputs: positive and negative (CONDITIONING), latent (LATENT), num_frames (INT) - all of which go straight into your sampler - plus shot_id (STRING), which is handy for labeling outputs so you know which saved clip belongs to which shot.

What it actually does

Not much, and that's the point. It bounds-checks the index and raises a clear error if the list is empty or the index is out of range - a nicer failure than a cryptic sampler crash one node later. The real design work is that the adapters already did the heavy lifting (per-shot conditioning, auto-pairing first/last frames for Wan); this node just keeps the loop ergonomics sane.

Honest notes

Nothing clever happens here, so there's no trick to miss. The one thing that'll trip you: this node assumes a loop. If you're only ever sampling one shot, you can skip it and wire the list's first element... except ComfyUI doesn't index lists that way, so just use index 0. It's a young pack without much community battle-testing, but this node in particular is simple enough that there's little to go wrong. Install the pack, wire the loop, and the main thing left to figure out is your video-combine stitch downstream.

CategoryTensorVizion/Director/Adapters

Inputs (2)

NameTypeDefaultDescription
wan_shotsTV_WAN_SHOTLISTβ€”
indexINT00–4096β€”

Outputs (5)

NameTypeDescription
positiveCONDITIONINGβ€”
negativeCONDITIONINGβ€”
latentLATENTβ€”
num_framesINTβ€”
shot_idSTRINGβ€”