Tip
Want to test upcoming experimental features? Switch to our beta branch!
A universal, stylish, and multi-functional (All-in-One) image loader for ComfyUI. Load, crop, mask, and scale images directly within a single convenient interface.
- 🌟 Key Features
- 🔌 Inputs and Outputs
- ⚙️ Operation Modes (Detailed Breakdown)
- ⌨️ Tricks and Shortcuts
- 🔄 Recent Updates
- 🛠️ Installation
- All-in-One: No more cluttering the graph with separate nodes for loading, cropping, color grading, and resizing.
- Built-in Crop Editor: Interactive crop frame directly on the node canvas.
- Smart Masking: Brush masking with full Undo/Redo history and zoom support.
- Professional Color Grading: Controls for exposure, contrast, highlights/shadows, color temperature, vibrance, vignetting, and HSL.
Visual representation of the node and its connections in the ComfyUI graph:
- in_image (optional) — external incoming image for processing.
- in_mask (optional) — external incoming mask.
- IMAGE — final processed image (including crop, color grading, and scaling).
- MASK — generated mask (drawn manually or passed from the input).
- original_input — raw, unprocessed source image.
- Note: If an external image is fed into the
in_imageport, this port is automaticallyblockedto prevent logical feedback loop errors.
- Note: If an external image is fed into the
The node's capabilities are divided into 3 switchable modes, always accessible on the control toolbar.
This mode is designed for standard image loading and basic processing. You can fine-tune colors, exposure, and contrast before passing the image down the graph. Double-click the Base tab to enter the advanced processing settings panel; double-click it again to exit.
| Standard Base Mode | Control Toolbar (BASE) |
|---|---|
 |
 |
Click the open live camera raw button to access a professional Camera Raw panel with advanced color correction, HSL adjustments, and Curve charts.
| Camera Raw Panel | Curves & HSL Settings |
|---|---|
 |
 |
A mode with a built-in graphic mask editor. Allows you to quickly paint an inpainting mask right inside the node.
Double-click the mask tab to enter the full-screen mask editor; double-click it again to exit.
| Control Toolbar (MASK) | Mask Editor Canvas |
|---|---|
 |
 |
- Mask Color (visual selection of the mask display color on the canvas). Note: The display color does not affect the output mask (the MASK output is always a standard black-and-white mask).
- Eye Icon (toggles mask visibility on the canvas).
- Undo / Redo Buttons — full action history for precise painting.
- Eraser (removes painted mask content).
- Trash Icon (clears the entire mask canvas).
- Sliders — smooth adjustment of brush size and hardness.
A professional tool to resize image resolution with aspect ratio locking and smart padding options.
| Control Toolbar (RESIZE) | Scaling Options |
|---|---|
 |
 |
The node is equipped with numerous hotkeys and hidden features to accelerate your workflow.
| Interactive Crop Editor | Auto-mask Outpaint | Context Menu |
|---|---|---|
 |
 |
 |
- Alt + Right Click + Drag — interactively adjust brush size (horizontal movement) and hardness (vertical movement) directly on the canvas.
- Ctrl + Left Click — smart flood fill of enclosed mask areas.
- Shift + Left Click — draws a straight line from the last painted point to the current click. Holding Shift while dragging locks the line to vertical or horizontal axes.
- Mouse Wheel — Zoom in/out of the canvas in full-screen mode.
- Middle Mouse Click / Wheel Click + Drag — pan around the canvas.
- Esc — quickly exit the full-screen masking mode.
- Auto-Mask Outpaint — when toggled on, areas outside the original frame are automatically converted into a mask.
- Feathering — smooth outpaint mask edges for seamless blending.
- Shift + Drag Corner Handle — forces a locked aspect ratio during cropping.
- Alt + Drag Corner Handle — scales the crop frame symmetrically relative to its center.
- Pixel Snap —
None,x2,x4,x8,x32,x64buttons round the dimensions and coordinates to the selected step for perfect rendering. - Mouse Wheel — Zoom in/out of the workspace.
- Middle Click / Alt + Left Click + Drag — pan around the canvas.
- Esc — close the editor without saving changes.
- Copy and Paste Masks — the node's context menu (right-click) includes built-in
Copy MaskandPaste Maskcommands. This allows you to instantly transfer masks between nodes without manual routing.
- Double-Click sliders & values — double-click any slider, numerical input, or label to instantly reset it to its default value (works on both node controls and Camera Raw panel).
- Double-Click
Masktab — toggle full-screen masking mode. - Double-Click
Basetab — toggle Camera Raw panel.
- HSL Color Picker (Finger Icon) — click and drag horizontally on any color in the image to dynamically adjust the saturation of that color range.
- Double-Click on Curve — resets the selected channel curve (RGB/Red/Green/Blue) to linear.
- Right-Click on Curve point — deletes the selected point.
- Mouse Wheel / Middle Click — zoom and pan the image for close inspection.
- Esc — close the editor without saving.
- Mask Editor Improvements: Added right-click (RMB) eraser support — hold RMB to dynamically erase mask paths for quick edits.
- CPO Editor Enhancements:
- Doubled the border snap strength for precise locking of the crop boundaries.
- Added an Alignment panel with quick presets (
Top-left,Center crop,Bottom-right, etc.). - Added image mirroring (horizontal/vertical) and 90° rotation (CW/CCW).
- Added scroll support to the sidebar for smaller screens.
- Outpaint Color Integration: Added a color palette of 7 standard colors + custom rainbow picker. The selected fill color is now used by
pad_for_outpainting.
- Open terminal in your ComfyUI custom nodes directory:
cd ComfyUI/custom_nodes - Clone this repository:
git clone https://github.com/trx7111/ComfyUI-TrixLoader.git
- Restart ComfyUI.
- Search for
ComfyUI-TrixLoaderinside ComfyUI Manager and install in one click.
- Created by Trix for the StableDif community.