Loop Video:
LoopVideo extends a short video by repeating its frames in order until it reaches a requested length. It can fill a target frame count or duration, or produce a chosen number of playthroughs. You can also adjust playback speed. At normal speed, the node repeats available audio in step with the video; at other speeds, it removes the audio to avoid an out-of-sync result. This makes it useful for turning a short clip into a longer sequence while keeping the frame order predictable.
Loop Video Input Parameters:
video
The VIDEO clip to repeat. The node reads its frames and frame rate, then cycles through the frames in their original order. It can also use the clip’s audio at normal speed. An input with no frames cannot be processed. The source tooltip mentions short clips, including MP4, WEBM, or another node’s output, but this socket receives a VIDEO value rather than a file path. No minimum, maximum, or default is specified in the provided interface.
length_mode
Selects how the requested length is determined: by frame count, duration, or number of playthroughs. It controls which length setting is used to calculate the result. The interface identifies this as a string choice, but the choices themselves and the default are defined outside the provided source, so their exact labels cannot be documented here. No minimum or maximum applies.
frames
Sets the requested frame count when the frame-count length mode is selected. More frames produce a longer sequence, with the source frames repeating as needed. This is an integer input. Its minimum, maximum, and default are not present in the provided source.
seconds
Sets the requested duration in seconds when the duration length mode is selected. The node uses the resulting frame rate to determine how many frames are needed, so playback speed can affect that calculation. This is a floating-point input. Its minimum, maximum, and default are not present in the provided source.
loops
Sets the requested number of playthroughs when the loop-count length mode is selected. A playthrough follows the source frames from beginning to end before starting again. This is an integer input. Its minimum, maximum, and default are not present in the provided source.
speed
Adjusts playback speed by changing the frame rate carried by the VIDEO result. The IMAGE result has no frame-rate setting, so the node instead selects frames to reflect the requested speed in that batch. Audio is retained and repeated only when speed is exactly 1.0; at any other speed, it is dropped. This is a floating-point input. Its minimum, maximum, and default are not present in the provided source.
Loop Video Output Parameters:
video
The looped VIDEO, containing frames repeated in their original order up to the calculated frame count. It carries the frame rate adjusted for the selected speed. At speed 1.0, it can also contain repeated audio when the input has usable audio; otherwise, its audio may be absent. Use this output when the next step needs a video with playback timing.
images
An IMAGE batch representing the looped visual sequence. At speed 1.0, it contains the same frames as the VIDEO output. At other speeds, the node selects frames to reflect the speed because an IMAGE batch cannot carry a frame rate. Use this output when the next step works with image batches rather than VIDEO values; it does not carry audio.
Loop Video Usage Tips:
- Use a short clip with a visually compatible beginning and end if you want the repeat point to be less noticeable. The node repeats existing frames; it does not create a transition between playthroughs.
- Choose the length mode that matches your task: frames for a precise frame count, seconds for a target duration, or loops for a specific number of playthroughs. The exact on-screen choice labels depend on the length-input definition, which was not included in the provided source.
- Keep speed at 1.0 when you need the input audio repeated with the video. The node fits the audio to one video playthrough before repeating it, so a slightly short audio track is padded and a longer one is trimmed for each loop.
- Use the VIDEO output when playback timing matters. Use the images output for image-processing workflows, and remember that an image batch has no frame-rate or audio information.
Loop Video Common Errors and Solutions:
This ComfyUI build has no VIDEO support (comfy_api.input_impl is unavailable): …
- Explanation: The node could not access the VIDEO components required to construct its result. The text after the colon contains the underlying import error.
- Solution: Use a ComfyUI build that provides the required VIDEO support, then restart ComfyUI. If the error remains, check the underlying import error for a missing or incompatible component.
The input video has no frames
- Explanation: The connected VIDEO contains zero images, so there is nothing to repeat.
- Solution: Check that the upstream video-loading or generation node produced frames, and connect a non-empty VIDEO to this node.
