IO_LoadShotBatch

This is the odd one out in the pack's batch-loader family - the others manage lists of images, text, audio, or video paths. IO_LoadShotBatch manages a list of shots: little bundles of cinematography metadata (duration, shot scale, camera movement, transition, a description, and a reference image) that you build one at a time with the companion node, IO_ShotCreate, and then review here as a storyboard.

How it works

Each shot arrives through the optional shot input (type SHOTINFO), chained in from IO_ShotCreate. The node stores the accumulated list internally as JSON in two fields - shot_state and shot_preview - which you won't hand-edit; they're the node's own bookkeeping, defaulting to an empty []. card_size (120–520, default 120, step 20) sets how large the storyboard cards render - notably a much bigger range than the image/audio/video batch loaders in this pack, because a shot card needs room to show a thumbnail plus its metadata, not just a filename. index (0–9999) picks which shot in the list is "current."

Inputs and outputs

• shot_state / shot_preview - internal JSON bookkeeping for the accumulated shot list; leave these alone.
• card_size - visual card size in the storyboard view.
• shot (optional, SHOTINFO) - chain in a new shot from IO_ShotCreate to add it to the list.
• index - which shot is currently selected.

Outputs: img_index (IMAGE, the current shot's reference image), text_index (STRING, presumably the shot's description or a formatted summary of its metadata), plus index and total so a downstream loop or display knows its position in the storyboard.

How to install it

ComfyUI Manager → search ComfyUI-Apt_Preset, install, restart. Manually:

cd ComfyUI/custom_nodes
git clone https://github.com/cardenluo/ComfyUI-Apt_Preset.git

then run install.bat for dependencies (Windows-only - on Linux/macOS run its pip install lines by hand) and restart ComfyUI.

Common issues & troubleshooting

This node is useless without IO_ShotCreate feeding it. If you drop IO_LoadShotBatch into a graph with nothing wired into shot, you'll just see an empty storyboard - build shots with IO_ShotCreate first, chaining each new one through the previous shot's output, then feed the final chain in here.

The storyboard view renders blank. Like the other visual batch loaders in this pack, this one draws its own gallery UI inside the node - exactly the kind of custom widget that's been breaking on some packs during ComfyUI's "Nodes 2.0" frontend migration. Try the legacy canvas if the cards don't show up after an update.

IMPORT FAILED on startup. There's at least one reported import failure for this pack in the wild on a stock install, generally traced to the install.bat dependency step being skipped - easy to do off Windows, where you have to run the commands inside it manually. Check the console for the actual missing package first.