Load Video + Crop:
LoadVideoCrop loads a video and lets you keep a fixed, visually selected area throughout the clip. Its preview is designed to show the crop before you use the result, making it easier to frame a subject for a chosen aspect ratio. The crop does not follow movement: the same area is used for every frame. You can also select a portion of the video by time. When cropping is active and the supported video path is available, the node can pass the video onward without loading the entire clip into memory; processing that needs all frames as image data will still use memory for those frames.
Load Video + Crop Input Parameters:
file
Select the video to load. The options are video files found in ComfyUI’s input directory, and the field also supports video upload. The selected file supplies the clip and the frame shown in the preview. No fixed default is specified; you must provide an available video file.
aspect_ratio
Choose the framing mode for the video. The default is Original, which returns the video through the core file-video path without cropping. Other choices enable the node’s fixed-crop video path, using the crop rectangle represented by the four crop fields. The available choices come from ASPECT_RATIOS, whose individual values are not included in the supplied source, so no further option names can be stated reliably.
crop_x
Set the left edge of the crop as a fraction of the frame width: 0 is the left edge and 1 is the right edge. Its default is 0.0, minimum is 0.0, maximum is 1.0, and step is 0.0001. The visual crop interface normally stores this value for you. Increasing it shifts the selected area to the right; the same position is used throughout the video when cropping is active.
crop_y
Set the top edge of the crop as a fraction of the frame height: 0 is the top and 1 is the bottom. Its default is 0.0, minimum is 0.0, maximum is 1.0, and step is 0.0001. The visual interface normally keeps it in sync with your selection. Increasing it shifts the fixed crop downward.
crop_w
Set the width of the crop as a fraction of the full frame width. Its default is 1.0, minimum is 0.0, maximum is 1.0, and step is 0.0001. For example, 0.5 represents half the frame width before the crop is fitted to valid pixel boundaries. The visual interface normally calculates this value. A width of 0.001 or less is treated as an invalid crop, so the crop operation returns the full frame instead.
crop_h
Set the height of the crop as a fraction of the full frame height. Its default is 1.0, minimum is 0.0, maximum is 1.0, and step is 0.0001. The visual interface normally calculates it alongside the other crop values. A height of 0.001 or less is treated as an invalid crop, so the crop operation returns the full frame instead. Valid crop dimensions are adjusted to even pixel sizes, which may shift a boundary slightly.
start_time
Choose where the output video begins, in seconds. Its default is 0.0, minimum is -100000, maximum is 100000, and step is 0.001. A positive value starts that many seconds into the file; a negative value counts back from the end. A value of 0.0 starts at the beginning. This setting trims the video output, but it does not set which frame the two image outputs show.
duration
Choose how many seconds of video to keep after start_time. Its default is 0.0, minimum is 0.0, no maximum is specified, and step is 0.001. A value of 0.0 means no duration limit; a positive value requests a clip of that length. Whether a request extending beyond the available video causes an error depends on strict_duration.
strict_duration
Decide whether the full requested duration is required. Its default is False; the available values are False and True. When True, the node raises an error if the trimmed video cannot satisfy the requested duration. Leave it False when you do not need the clip to have the exact requested length.
frame_time
Choose which moment in the source file supplies the two image outputs, in seconds. Its default is 0.0, minimum is 0.0, maximum is 100000, and step is 0.001. The frontend normally keeps this value synchronized with the preview player, but you can set it manually to export a frame from a specific moment. It does not change the video’s trim window. If it exceeds the file’s known duration, the node limits the preview request to near the end of the file.
Load Video + Crop Output Parameters:
VIDEO
The loaded video, with the requested time trim applied. In Original mode, its video content remains uncropped; in a crop mode, a fixed rectangle is applied to every frame. This is the output to connect to later video-processing or saving nodes. When the supported lazy crop path is used, the video need not be fully decoded merely to pass it onward, although a downstream node that requests all frames as tensors will materialize them.
FULL FRAME
An image of the full frame selected by frame_time, before cropping. It is useful for comparing the original composition with the selected area or for using a single source frame elsewhere in your workflow. It shows a moment from the source file, independently of the video output’s trim settings.
CROPPED FRAME
An image of the frame selected by frame_time, restricted to the crop rectangle. Use it to check the framing or send that single cropped still to an image-processing node. With the default full-frame crop values, it is identical to FULL FRAME. Selecting Original leaves the VIDEO output uncropped, but the image preview still uses the crop coordinates supplied to the node.
Load Video + Crop Usage Tips:
- Choose a non-
Originalaspect ratio and position the crop in the preview before processing a long clip. The rectangle stays in one place, so check that a moving subject remains inside it at several moments. - Keep
aspect_ratioatOriginalwhen you only need to load or trim the video. This uses the core file-video path rather than the crop path. - Use
start_timeanddurationto select a segment of the video. Useframe_timeseparately when you need the image outputs to show a particular moment; changing it does not move the trim window. - Turn on
strict_durationwhen an exact requested clip length matters. Leave it off when reaching the end of the source before that length is acceptable. - For long cropped videos, pass
VIDEOto a compatible saving step when possible. Saving on the supported crop path processes frames one at a time; a step that requests all video frames as tensors will still need memory for the cropped clip. - Use an 8-bit SDR source for the supported streaming-save path. That path explicitly rejects higher-bit-depth and HDR sources, as well as sources whose frames carry rotation metadata.
Load Video + Crop Common Errors and Solutions:
Invalid video file: <file>
- Explanation: The selected file cannot be found through ComfyUI’s annotated input-file lookup when the node validates its inputs.
- Solution: Re-select or upload the video, and confirm that the file is still available in the input location.
Failed to slice video: Source duration: ... Start time: ... Target duration: ...
- Explanation: The requested trim could not be produced. This can occur when
strict_durationis enabled and the available video afterstart_timeis shorter thanduration. - Solution: Move
start_timeearlier, request a shorterduration, or disablestrict_durationif a shorter result is acceptable.
No video stream found in file '<path>'
- Explanation: The crop video path opened the file but did not find a video stream.
- Solution: Select a file that contains playable video. If you uploaded a file with a video extension, verify that it actually contains video rather than audio alone.
No video stream found in file
- Explanation: The frame-preview path could not obtain a video stream for the image outputs.
- Solution: Check that the selected file contains video and can be decoded, then try another valid video file if necessary.
Load Video + Crop v1 streaming save supports SDR (sRGB) output only
- Explanation: A downstream save request specified an output color space other than
sRGB, which this crop-saving path does not support. - Solution: Save the cropped result with
sRGBoutput settings, or use a different processing path for the required color space.
Load Video + Crop v1 streaming save supports 8-bit output only
- Explanation: A downstream save request specified an output bit depth other than 8 bits.
- Solution: Set the save output to 8-bit, or use another path if your deliverable requires a higher bit depth.
Load Video + Crop v1 streaming save does not support <bit depth>-bit sources; save without a crop (aspect ratio Original) to re-encode via the core path
- Explanation: The source exceeds the 8-bit limit of the supported cropped streaming-save path.
- Solution: Use an 8-bit source for cropped streaming output. If you do not need the crop, select
Originalto use the core path identified by the error.
Load Video + Crop v1 streaming save does not support <color space> sources; save without a crop (aspect ratio Original) to re-encode via the core path
- Explanation: The source is identified as
HDRorHDR PQ, which the cropped streaming-save path rejects. - Solution: Use a suitable SDR source for this crop path. If cropping is unnecessary, select
Originalto use the core path identified by the error.
Load Video + Crop v1 does not support rotated sources on the tensor path; use a source without rotation metadata
- Explanation: A downstream step requested the cropped video as frame tensors, but the source frames carry rotation metadata. The preview image may still appear rotated correctly because its frame-preview path handles rotation separately.
- Solution: Use a source whose orientation has already been applied to its pixels and whose rotation metadata has been removed, then load it again.
