Extensions/Image Crop Edit
ComfyUI Extension

Image Crop Edit

Visual free crop and horizontal straighten rotate node for ComfyUI.

By Luna-visual·Created 2 days ago·Updated 2 days ago· 0
Luna-visual/ComfyUI-ImageCropEdit
Nodes1
On cloudLocal install
Categoryimage/crop
Stars0
Updated2 days ago

Nodes (1)

Image Crop Edit

Crop and straighten photos without leaving your ComfyUI graph

image/crop
Readme

Image Crop Edit

A standalone ComfyUI custom node for Photoshop-like crop framing, anchor-based zoom/rotate, and iPhone-style straighten control.

Install

ComfyUI Manager: search Image Crop Edit or ComfyUI-ImageCropEdit after the registry entry is live.

Manual:

cd ComfyUI/custom_nodes
git clone https://github.com/Luna-visual/ComfyUI-ImageCropEdit

Restart ComfyUI, then hard-refresh the browser (Ctrl+F5).

The node is at Add Node → image → crop → Image Crop Edit.

Usage

  1. Connect an IMAGE to image. The viewport uses the last connected image size, not the original Load Image file size.
  2. Load Image (or another file loader) appears in the viewport right away. No play click is required.
  3. Resize or other processed nodes: press the play button on this node (the toolbar above the title, same as Save Image). That runs the upstream nodes and loads their output, for example 1920×1080 after a resize.
  4. Original sets the crop box to the full input size.
  5. Free: drag corners or edges to resize the crop box. Drag inside the box (not on the yellow anchor) to move the box. Drag the yellow anchor, or drag outside the box, to move the image.
  6. Scroll to zoom the image inside a fixed canvas (the input size), like Photoshop. Zoom and rotate pivot around the yellow anchor. The canvas does not grow. The crop box cannot leave the canvas, but it can cover empty canvas areas; those pixels output as black.
  7. Double-click the canvas to place the yellow transform anchor. It starts at the image center. The anchor is a hollow yellow crosshair.
  8. Drag the bottom ruler to rotate within ±45° around the anchor. The crop box stays level. Use Rotate 90° for quarter turns; the long side is scaled to fit the canvas.
  9. Reset restores the original framing. Undo steps back up to 20 edits (crop state only, not VRAM).
  10. Aspect ratios: Free / Original / 1:1 / 4:3 / 3:4 / 16:9 / 9:16.

All crop, move, zoom, and rotate actions are shown live in the viewport.

Outputs

  • cropped: cropped RGB image
  • mask: valid-area alpha

Publish Notes

  • Registry metadata is defined in pyproject.toml.
  • Publisher id: lunavisual
  • Repository: https://github.com/Luna-visual/ComfyUI-ImageCropEdit
  • To publish through GitHub Actions, add a repository secret named REGISTRY_ACCESS_TOKEN.

License

Luna-visual Source License (Non-Sale): free to use (including in commercial projects); you may not sell this plugin or include it in paid packs without permission. See LICENSE.