🎬AGSoft Load Video

A video loader that accepts a path, a file picker, or another loader's output

By Art-xmaster·Created 12 months ago·Updated a day ago· 23

🎬AGSoft Load Video

input_video

video
video_path
width
height
duration

◄custom_path►

◄video▾►

Video in ComfyUI is a mess of competing loaders - Video Helper Suite has one, core ComfyUI has one, and they hand you slightly different objects. AGSoft Load Video is a compatibility shim: it accepts a video three different ways, resolves the absolute file path for you, and hands back the VIDEO object plus that path. If you've ever had a video node refuse to work because it wanted a file path you didn't have, this is the node that unblocks you.

The three ways in

The node's input priority is explicitly documented and worth internalizing:

input_video - an external VIDEO object, say from VHS's Load Video. Highest priority. If you plug one in, everything else is ignored. This makes the node a pass-through that also gives you the resolved path.
custom_path - a string path to a video file on disk. Medium priority, used when no VIDEO object is attached.
video_file - a dropdown that lists videos from ComfyUI's input folder, the same way the stock image loader lists images. Lowest priority, but the most beginner-friendly - no path typing at all.

What it returns is the part that makes it worth having in your graph even when you already have a video loader: video (VIDEO) and video_path (STRING), the absolute path. Lots of nodes in the video ecosystem - the AGSoft video pack included - want the path for logging, saving, or re-reading, and this node hands it to you without digging through internals.

How it works

The mechanism is straightforward priority handling. If an external video object is connected, it tries to extract that object's source path (via its stream source API) and returns it. Otherwise it resolves custom_path if it exists on disk, then falls back to the annotated file path from the input folder. It resolves everything to an absolute path so downstream nodes don't have to guess relative to their own working directory.

Installation

Part of comfyui-AGSoft:

cd ComfyUI/custom_nodes
git clone https://github.com/Art-xmaster/comfyui-AGSoft.git
# restart ComfyUI

Or via ComfyUI Manager (search "comfyui-AGSoft"). No model downloads. Video decoding itself comes from whatever video backend ComfyUI already has - if you want VHS-style features, the pack doesn't reimplement them, it just routes around them.

Where people get burned

Priority-order confusion, again - the pack's video nodes all share this pattern. Plug in an input_video and a custom_path simultaneously and the path is silently ignored; that's by design, not a bug. Second, video_file only lists files in the input folder, so files elsewhere need custom_path. And it's a loader/path-resolver, not a decoder: don't expect frames out. For that, pair it with the pack's LastFrameExtractor or the video frame nodes downstream.

CategoryAGSoft/Video

Inputs (3)

Name	Type	Description
input_videoopt	VIDEO	Optional: accept video from another node (highest priority). If connected, other inputs are ignored. The file path is extracted automatically from the VIDEO object. --- Опционально: принимает видео от другой ноды (наивысший приоритет). Если подключён, другие входы игнорируются. Путь к файлу извлекается автоматически из объекта VIDEO.
custom_pathopt	STRING	Optional: absolute path to a video file. Overrides the dropdown if input_video is not connected. Always use absolute paths. Example (Windows): C:/videos/my_video.mp4 Example (Linux/Mac): /home/user/videos/my_video.mov --- Опционально: абсолютный путь к видеофайлу. Переопределяет список, если не подключён внешний вход. Всегда используйте абсолютные пути. Пример (Windows): C:/videos/my_video.mp4 Пример (Linux/Mac): /home/user/videos/my_video.mov
videoopt	COMBO	Select / upload a video file from the input directory. Used when no external video and no custom path are set. Files are uploaded in a single streaming request with progress. You can also drag&drop a video file from the OS explorer onto the node. Supported formats: MP4, AVI, MOV, WEBM, MKV and other common formats. --- Выберите / загрузите видеофайл из папки input. Используется, когда не подключён внешний вход и не указан кастомный путь. Файлы загружаются одним потоковым запросом с прогрессом. Также можно просто перетащить видеофайл из проводника прямо на ноду. Поддерживаемые форматы: MP4, AVI, MOV, WEBM, MKV и другие распространённые.

Outputs (5)

Name	Type	Description
video	VIDEO	—
video_path	STRING	—
width	INT	—
height	INT	—
duration	FLOAT	—