Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > ComfyUI-LoadVideoCrop > Load Video + Crop

ComfyUI Node: Load Video + Crop

Class Name

LoadVideoCrop

Category
video
Author
domg73 (Account age: 127days)
Extension
ComfyUI-LoadVideoCrop
Latest Updated
2026-09-29
Github Stars
0.01K

How to Install ComfyUI-LoadVideoCrop

Install this extension via the ComfyUI Manager by searching for ComfyUI-LoadVideoCrop
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-LoadVideoCrop in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

Load Video + Crop Description

Loads and trims video with a visually selected fixed crop, plus full and cropped frame previews.

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-Original aspect 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_ratio at Original when you only need to load or trim the video. This uses the core file-video path rather than the crop path.
  • Use start_time and duration to select a segment of the video. Use frame_time separately when you need the image outputs to show a particular moment; changing it does not move the trim window.
  • Turn on strict_duration when 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 VIDEO to 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_duration is enabled and the available video after start_time is shorter than duration.
  • Solution: Move start_time earlier, request a shorter duration, or disable strict_duration if 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 sRGB output 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 Original to 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 HDR or HDR PQ, which the cropped streaming-save path rejects.
  • Solution: Use a suitable SDR source for this crop path. If cropping is unnecessary, select Original to 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.

Load Video + Crop Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI-LoadVideoCrop
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

Load Video + Crop