ComfyUI Extension: ComfyUI-enricos-nodes

Create complex compositions the FAST and EASY way (V4 Alpha is out!)

How many times do you need want to create something like this ?

Well, This node was created to make the composition process quick and easy!

The Compositor Node

With the Compositor Node you can:

• Create quick compositions: Pass up to 8 images and visually place, rotate, scale, and flip them

• Manage Layers: Drag-to-reorder layers, toggle visibility, preview images and masks side-by-side

• Quickly set a background color: Easily choose the background color or keep transparent!

• Draw: Sketch and annotate easily with Paint/erase on foreground layer with adjustable brush (size, color, shape)

• Erase while drawing: simply ctrl+draw to erase while in draw mode

• Transform: Flip H/V, stretch to fit, align selected objects, rotate with precision

• Perform smart selections: Precise pixel-level selection mode, snap-to-grid for alignment

• Do numerical transforms: Numerical width/height boxes for exact dimensions

• Auto-Save your edits: Automatic upload when composition changes

• Create stable assets: well defined outputs and temporary images.

• Reset your canvas: you lost your image outside of screeen: Reset All button to restore initial configuration, select and move via layers.

• Reload with no fear: Remember positions, scaling, rotations, z-index across generations and reloads

• Save on resources: Choose where to save inputs so they will persist reloads

• Park your assets: Extra padding area to park assets or reach transform handles

• Visualize your composition: Clear green border indicating the exact exported region

• Preview Masks: See masks in your layers

• Precisely move with keyboard: Arrow keys for precise 1px nudging (Shift for 10px)

• Handle multiple object easily: Multi-select and transform multiple layers together

• Export more than images: Export final image, and other information

Changelog

• v 4.0.0 Alpha - 16.11.2025 new gui with tools, reload and remember, refactored code.

• major rewrite: Complete UI overhaul with enhanced workflow!

• new feature: Layers Panel - Visual layer management with thumbnails for images and masks, drag-to-reorder, visibility toggles

• new feature: Drawing Tools - Foreground layer with brush/eraser modes, color picker, adjustable brush size and shape (circle/square)

• new feature: Enhanced Toolbar - Comprehensive transformation controls (flip H/V, stretch, align), snap-to-grid, precise selection mode

• new feature: Numerical Inputs - Direct width/height control with real-time feedback, rotation slider with snap (Shift for 5° increments)

• new feature: Save & Reset - Auto-save on mouse-out with visual feedback (orange flash), Reset All button to restore initial state

• enhancement: Mask Preview - Side-by-side image and mask thumbnails with opacity indicators

• enhancement: Improved Alignment - Composition border now pixel-perfect with export area

• technicalities: Input options with the new configuration you can choose the quality of the input (saved to disk) and position: the tmp folder is temporary and will not on reload persist reloads. save to output in by default in a well isolated folder with unique names

• _Attention!!!: This is an Alpha preview, v3 still there. :

Known Issues / Work in Progress:

• Erase canvas might restore erased foreground in certain cases
• Positions are not always pixel-perfect (sub-pixel rounding)
• Some transformation tools can be unreliable (equalize/distribute disabled)
• Temporary remmoved mask output and advanced outputs.
• Can be very heavy depending on the size of canvas and imported images, keep it reasonable in size. avoid importing 8 4k images in a 4k canvas...

Previous versions changelog

<details> <summary><b>click here to expand</b> the changelog...</summary> - v **3.1.5** - 04.05.2025 - _new feature_: **Mask outputs!** you asked for it so there you go: A new node that outputs the layers and their masks! search for the compositor masks output node and connect it to the new layer_outputs output socket. note: mask stacking (subtract top masks from the bekow ones will come later) - _new node_ :a new **color picker node** (specify rgb coordinates or use the eyedropper and connect the 24 bit output to connect to color inputs). - _bugfix_: fixed a regression for which the composition overlay was not being superimposed the composition while moving objects and z-stacking not being preserved until save - _sample workflow_: [a sample workflow with assets can be found in the /assets/workflows folder](/assets/workflows/compositorMasksV3_sample.json) - v **3.1.3 & 3.1.4** - fix regression due to comfy change, not sure what else is brooken but ... reinstance the node. might be that reloading a flow does not preserve anymore the configurations - v **3.1.2** - merge pr for comfyui official registry - v **3.1.1** - 23.03.2025 fixed gui not showing up in comfy frontend higher Comfy 1.1.18+ - v **3.1.0** - 20.09.2024

• new configuration feature: onConfigChange action toggle when you change the configuration (or any of the attached nodes) you can now choose if:

  • you want to stop the flow to allow edits
  • or you want to grab a capture and continue the flow
    $${\color{red}Important}$$! this option stops, uploads the composition and re-enqueues your prompt (there is no real pause) so careful with random seeds on the left of the node or it will loop!

• new configuration feature: normalize height when this is activated your images will all be the same height of the canvas (this can lower image quality)

• transforms enhancement: output transforms now give you back the angle and bounding box coordinates

• transforms enhancement: you can force transform outputput values to be integers (as some nodes requires it)

• new feature: (experimental and limited): Tools ! this is an experimental feature. it allows controlling some aspects of the compositor.

  • precise selection toggle ignore transparent pixels and select the first image below the mouse
  • center selected puts the selected images in the center of canvas
  • reset transforms zeroes out the changes to images bringing them to their original size, angle and 0,0 location (top left)
  • limitations: as saving discards the selection, and it happens on mouse out
    you might need to re-select to use centering and reset

• v 3.0.8 - 18.09.2024
  • new feature: invert mask option. the implementation of mask was not correct. now it's possible to invert the mask via toggle.
  • new feature: angle output the angle of rotation is now accessible in the output (and soon the bounding box x,y, width and height).
  • bugfix: fix cut images on swap due to wrongly preserved width and height
  • _new feature: added force int to allow the outputs to be used with set area conditioning (that requires int)
• v 3.0.4 - 18.09.2024 - bugfix: the width and height stored in transforms were swapped and the output node would report them incorrectly. thanks @sky958958 for spotting it
• v 3.0.2 - 17.09.2024 - friendly transforms for area prompting!
  With the goal of being able to do regional area prompting,
  now you can easily output each input x,y coordinates and their scaled width and height with the help of the new Transform Output node! select the channel corresponding the input and the node will output the values for you.
  • enhancement: a new node outputs x,y,width,height other images into a convenient node to be attached to the transforms output
  • enhancement: save and restore skew from transform (now you can distort your images to help fake perspective)
• v 3.0.0 - 16.09.2024 - this release is a full rewrite of the code and fixes: - issues #45 , #34, #18 also, and adds new features: - enhancement: simplified control panel (cature on queue, save transform, pause are removed as not needed anymore) - new feature: automatic upload of the output on mouse out of the canvas area (no need to click capture) - new feature: flash on save (once the image is uploaded the composition area green border briefly flashes in orange) - new feature: preliminary work for optional control panels (they will contain alignment controls, and other tools) - enhancement: enqueue with continue, on the first run, if necessary information is missing (like output) the flow will stop, make your composition, and click continue to re-enqueue the flash finishes.
  • v 2.0.4 - 06.09.2024 - enhancement: You can now scale the selected image via mouse wheel!
  • v 2.0.1 - 05.09.2024 - V2 is HERE!
    • enhancement: An all new widget layout with maximized working area and less clutter
    • new feature: A new companion configuration widget to allow more control and easier maintenance
    • enhancement: More control! it's now possible to select an image or group and then "alt+drag" to center scale and rotate
    • new feature: More control! it's now possible to nudge a selection by one pixel by using keyboard arrows, and while holding shift the movement is 10px! pixel perfect alignments!
    • new feature: the node now remembers the transforms you have applied, on the new run it will re-apply the stored transforms (storing transforms is controlled in the config)
    • new feature: masks are here! you can now pass masks, and they will be applied automatically! (depending on the results you might want still to invert them)
    • regression: a bit annoying but is_changed is not being observed so flows are re-triggered even on fixed
    • regression: img in workflow saved is not visible anymore
  • V 1.0.9 - 30.08.2024 - Huge refactoring!
    • new feature: multiple instances are now possible
    • bugfix: zooming out does not hide the compositor images anymore
    • bugfix: when saving a png with the workflow the compositor content is now visible (will not be restored...yet)
    • enhancement: the node does not re-trigger the execution of the flow if the image is not changed
    • performance: the node is now more efficient and correctly implements the is_changed check via checksum, avoiding re-triggering flows downstream if the composition has not changed
    • maintainability: the node is now refactored and better engineered, with a lot of comments. could be a good use case for those learning to code comfy extensions.
  • V 1.0.8 - 28.08.2024 - new feature: safe area indication - a green border is overlaid on top of the composition to indicate the exported area
  • V 1.0.7 - 28.08.2024 - new feature: preserve stacking order. when selecting a node, it's z-order is preserved image1 being the background/farthest and image8 the foreground/closest.
    • the first connected node will be the most distant from camera (background)
    • the last will be the closest to camera (subject/foreground)
  • V 1.0.4 - 27.08.2024 - new feature: now it's possible to pause the flow with a switch to avoid processing an unfinished composition
  </details>

Setup

Method 1: git clone open the custom nodes directory in your editor and

git clone https://github.com/erosDiffusion/ComfyUI-enricos-nodes.git

like all other custom nodes (that are not integrated with manager)

Method 2: ComfyUi Manager In Comfy UI Manager search "Compositor" and select the node from erosDiffusion and press install.

Method 3: via manager's button open ComfyUI manager click on Install via Git URL and paste this url

https://github.com/erosDiffusion/ComfyUI-enricos-nodes.git

if you get: "This action is not allowed with this security level configuration" then check your manager config.ini as discussed here: and set the security to weak (at your risk)

Reasons and How To use

Why this node ?

• I wanted to learn how to create custom nodes with a GUI in ComfyUI
• be able to composite visually images in ComfyUI
• be able to have image inputs that are generated on the fly in the composition
• be able to remember sizing and position across usages/generations
• have more room to manipulate objects around/outside the generated image
• fast forward to 2025, almost 2026 now we have edit models and other goodies still... with qwen image edit and fuse lora, quick mockups are still useful
• use as canvas for other editing tools to "direct" your scene... annotate and reframe, quickly setup a moodboard for edit models or drive animations...
• make nice collages

Alternatives ?

• the painter node is great and works better and does a million things more, but it misses some of these features.
• continue compositing your image like caveman using pixel coordinates
• well...photoshop ** if you have it** and import via million clicks or with a plugin
• finally use Krita which is good powerful and free
• oh and Blender also has a great plugin but you need to know/learn blender
• invokeai
• plethora of tools available in 2025 but this one is in comfy and it will get better soon :D

How to use

Quick Start (V4):

1. Search "Compositor" (V4) and "Compositor Config" (V4) in the node menu
2. Connect Config node to Compositor's config input
3. Configure: width, height, padding (extra space around canvas for easier manipulation)
4. Connect up to 8 images and optional masks to Config node
5. Important: Connect Compositor's image output (to Save Image, Preview, etc.)
6. Run once - flow stops to let you compose (if no prior composition exists)
7. Compose your scene using the tools (see below)
8. Mouse out of canvas area (green border flashes orange = saved)
9. Click Continue or Queue to process with your composition

Compositor V4 Interface:

Layers Panel (right side):

• Foreground - Drawing layer (paint/erase)
• Layers 1-8 - Your input images with thumbnails
• Mask Preview - Small square showing mask state (bright=active, dim=disabled)
• Visibility Toggle - Click layer to select, drag to reorder z-index
• Background - Bottom-most layer

Toolbar (top scrollable):

• Alignment: 9 buttons (←↑→↓ corners/center) - Align selected objects
• Flip/Stretch: ⇄⇵ flip H/V, ⬌⬍ stretch to fit canvas width/height
• Snap/Grid: Toggle snap-to-grid, adjust grid size (1-50px)
• Rotate/Precise: Rotation slider (0-360°, Shift=snap to 5°), precise pixel selection toggle
• Mode Buttons: Select/Draw/Erase (hold Ctrl to temporarily switch)
• Draw Tools: Color picker, brush width, Clear FG button (erase mode)
• Brush Shape: ● circle / ■ square
• Size Controls: Direct W/H input boxes for selected objects

Config Node Options:

• Width/Height: Composition canvas dimensions
• Padding: Buffer zone around canvas (default 100px)
• Normalize Height: Scale all inputs to same height (may reduce quality)
• onConfigChangedContinue: Auto-continue vs Stop for manual edits
• Invert Mask: Flip mask alpha channels
• Save Format: PNG (0-9), JPEG, WebP, BMP compression levels
• Save Folder: Output destination (temp/input/output)

Advanced Usage

Selection & Transform:

• Click to select single layer
• Drag empty area to box-select multiple
• Shift+Click to add/remove from selection
• Arrow keys: nudge 1px (Shift=10px)
• Mouse wheel: scale selected layer
• Drag corners: resize (Alt=center-based, Ctrl=free aspect)
• Rotation handle: rotate (Shift=snap to 5°)

Drawing Mode:

• Select Draw/Erase mode from toolbar
• Hold Ctrl to temporarily switch between draw/erase
• Adjust brush width (1-50px) and shape (circle/square)
• Change color with color picker (draw mode)
• Clear FG button removes all drawings

Tips:

• Mouse-out canvas to auto-save (orange flash = confirmed)
• Use Reset All button to restore initial positions
• Snap-to-grid helps with precise alignment
• Precise selection mode ignores transparent pixels
• Padding area lets you park/manipulate layers outside export zone

Aupporting nodes I use with this one

• Rembg(batch) -> from https://github.com/Mamaaaamooooo/batchImg-rembg-ComfyUI-nodes.git -> extracts the subject and returns a rgba image
• any other technique to create masks (grounding dino, sam, florence2...)
• any controlnet depth for your model - works well with depth anything v2 preprocessor for both 1.5 (regular controlnet) and xl (via union controlnet) or lineart (like anylineart), for flux you can try x-labs controlnet (but it does not work well for me)

Demo Workflow for v3.1

Just throw the worst possible images you find on the internet or that you can generate... ...scale and align quick, give a depth controlnet, describe the full scene and style, render... and you will get:

with the V3.1 workflow in json format you are in pixel perfect positioning control of your scene and content ! Images to replicate are in the assets folder.

Final words and limitations

• limitation you need to run the flow once for the compositor to show images
• limitation careful on random values on the left of the node, the node stops the execution on config change to be able to grab a capture and re-enqueues the flow. if the cache is invalidated you not be able to go next see here https://github.com/erosDiffusion/ComfyUI-enricos-nodes/issues/63
  when I tried implementing threading pause it was not reliable, so I resorted to stop / restart. another option would be a while loop...but that feels not right.
• tools new tools only show up on load, so if you add them, reload page with browser reload
• known issue: the compositing is not scaled, so if you want a 5k image well... I hope you have a big enough monitor, but it's not (yet) the goal of this node...

Now go put a zombie in a Gui !

Quick Start:

1. Install dependencies: pip install -r requirements_qwen.txt
2. Add "💜 Qwen Vision Loader" and "💜 Qwen Vision Processor" nodes
3. Connect your image and text prompt
4. Generate detailed descriptions, extract text, or answer questions about images!

See QWEN_INTEGRATION.md for detailed documentation and examples.

---

yours, ErosDiffusion 💜