IO_LoadVideoBatch

The video entry in this pack's small family of "visualization batch loading" nodes - the same pattern also covers images, audio, text, and shot data. IO_LoadVideoBatch holds a list of video file paths, shows them as a strip of cards inside the node, and lets you both grab the whole list and step through it one clip at a time.

How it works

video_list holds the paths, one per line, built in the widget. card_size (64–384, default 64) is purely cosmetic - how big the thumbnail cards render. index (0–9999) picks which entry is current. There's an optional video_list_in (STRING) input for feeding the list in from elsewhere instead of typing it - IO_PathProcessor's NewPathList output is the natural fit if you want filtering, regex matching, or numeric sorting applied to the file list before it lands here.

Like its audio counterpart, this node manages paths, not decoded video - video_list, video_index, and name_index are all STRING types. You still need a real video-loading node downstream to actually read the clip at that path.

Inputs and outputs

• video_list - the multiline list of file paths.
• card_size - cosmetic card size.
• index - which entry is currently selected.
• video_list_in (optional) - feed the list in from upstream instead of typing it.

Outputs: video_list (the full STRING list), video_index and name_index (the current path and filename), plus index and total for anything downstream tracking position in the sequence.

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, so on Linux/macOS run the pip install lines inside it yourself - and restart ComfyUI.

Common issues & troubleshooting

Expecting a decoded video output. This is the recurring trip-up across this whole batch-loader family: the node organizes and steps through paths, it doesn't decode media itself. Wire video_index into whatever actual video-loading node your workflow uses.

Gallery view renders blank or unresponsive. The in-node card gallery is a custom widget, and those are exactly the kind of thing that's broken on various packs during ComfyUI's ongoing "Nodes 2.0" frontend rewrite. Try the legacy canvas mode before assuming the node itself is broken.

IMPORT FAILED at startup. There's at least one reported case of this pack failing to import on a stock install, usually traced to skipping install.bat's dependency step - which needs to be run by hand on anything other than Windows. Check the console for the actual missing package before reinstalling.