Storyboard Previewer

Storyboard Previewer is the checkout counter of a storyboard pipeline: you feed it the shots you generated - images, video files, and the JSON that describes each shot - and it renders the whole thing as a grid of cards in the UI, one per shot, with the thumbnail, a playable video where there is one, and the shot's metadata (prompt, dialogue, camera notes) laid out underneath. It's a display node, new in the pack's 1.0.7 release, and it's aimed squarely at people doing narrative video work in ComfyUI.

The AIGV category name is a hint at the audience: this is for the AI-generated-video / storyboard crowd. If you're generating a shot list - LLM writes the shot data, an image model makes a keyframe per shot, a video model turns some of them into clips - this is the node that lets you actually look at the whole sequence instead of dragging images out of the output folder one at a time.

What each input does

Three optional inputs, and the useful fact is that it accepts batches of them:

• image_batch (IMAGE) - the keyframes/thumbnails, one per shot. Each image in the batch becomes a card.
• video_paths_list (STRING, JSON) - paths to video files, matched to cards by position. The node copies each video into ComfyUI's temp folder (hashed filename, so re-runs don't duplicate) and plays it inline.
• shot_content_json (STRING, JSON, DICT, LIST) - the metadata per shot. Each dict's key/value pairs become the card's label list, so dialogue, prompts, and timing all show up under the thumbnail.

Everything is position-matched: card i gets image i, video i, and metadata i. The node reads the longest of the three as the card count. Since it's an output node with no output ports, its only product is what you see on the canvas - plus an export path: the frontend adds HTML and image export buttons, so you can ship the whole storyboard as a document without screenshotting.

Install

Part of Comfyui-PixNodes. ComfyUI Manager → search "PixNodes" → install → restart, or:

cd ComfyUI/custom_nodes
git clone https://github.com/pixixai/Comfyui-PixNodes

then restart. (The README's manual-install block points at the wrong repo, ComfyUI-AlignLayout - use the URL above.) No models, no heavy deps - the videos are your own files.

Where it trips people up

The matching is by position, so a storyboard where some shots have video and others don't needs the lists padded with None/empty entries or the alignment drifts. Video paths must be real files on the machine - the node resolves them relative to ComfyUI's input/output folders too, but a nonexistent path just becomes an empty card, silently. And remember it's a previewer: nothing flows out of it, so keep a Save Image or Video Combine wired in parallel if you need the actual files. For iterating on a shot list without leaving ComfyUI, though, it turns "let me check all 20 shots" into one glance.