MachinePainting
95e4b9e2ce
New Nodes: - Blur Pro: 5 blur types (Gaussian, Surface, Box, Median, Motion) with dynamic UI, mask support, large radius optimization, preview - Noise Grain Pro: Film grain with size, sharpness, color/mono, 6 blend modes, seed, mask support - Frequency Separate: Split image into high/low frequency layers for retouching (subtract/divide modes) - Frequency Combine: Recombine edited frequency layers - Inpaint Mask Pro: Inpaint mask management with mask cropping, SEGS support, multi-color overlay preview - Image <> Mask Switch: Toggle conversion between IMAGE and MASK types Also: updated README, version bump to 2.1.0, added .claude/ and .codex/ to .gitignore
ComfyUI-MachinePaintingNodes
Professional Image Editing & Adjustments, Curves, color grading, mask tools, filters, and advanced utilities for your ComfyUI workflows
A comprehensive node suite for professional level image processing, color correction, frequency separation, film grain, blur tools, inpainting mask management, and advanced workflow enhancement utilities.
New Nodes
| Node | Category | Date Added |
|---|---|---|
| Blur Pro | Filters | 2026-03-27 |
| Noise Grain Pro | Filters | 2026-03-27 |
| Frequency Separate | Filters | 2026-03-27 |
| Frequency Combine | Filters | 2026-03-27 |
| Inpaint Mask Pro | Mask | 2026-03-27 |
| Image <> Mask Switch | Utilities | 2026-03-27 |
(All current nodes.)
Installation
ComfyUI Manager (Recommended)
Search for "MachinePaintingNodes" in ComfyUI Manager and install.
Manual Installation
cd ComfyUI/custom_nodes
git clone https://github.com/machinepainting/ComfyUI-MachinePaintingNodes.git
Dependencies
pip install -r requirements.txt
Nodes (38 Total)
Color Adjustment
(example)
| Node | Description |
|---|---|
| Curves Adjust Pro | Interactive Photoshop-style curves with RGB/R/G/B channels, 17 presets, mask support, channel-mask support |
| Levels Adjust | Black point, white point, gamma, output levels |
| Auto Levels | Automatic levels correction |
| Selective Color Pro | CMYK adjustments for specific color ranges and fine tuned color adjustments (reds, yellows, greens, cyans, blues, magentas, whites, neutrals, blacks) |
| Brightness Contrast Adjust | Simple brightness and contrast controls with simple slider controls |
| Color Match Blend | Match colors from one image to another with multiple methods (statistical, histogram, reinhard), blend modes, and adjustments |
| Color Adjust Blend | Color match with blend modes, plus RGB color balance for Shadows, Mid-Range, and Highlights |
| LUT Apply | Apply .cube/.3dl LUT files for cinematic color grading (includes 5 bundled LUTs) |
(examples)
Filters
| Node | Description |
|---|---|
| Blur Pro | Professional multi-type blur with 5 modes: Gaussian, Surface (bilateral/edge-preserving), Box, Median, and Motion blur. Per-type dynamic sliders, mask-controlled application, strength blending, optional mask blurring, in-node preview. Large radius optimization for fast processing at high values. |
| Noise Grain Pro | Realistic film grain/noise generator with grain size, sharpness, color/mono toggle, saturation control, seed for reproducibility. 6 blend modes: overlay, soft light, hard light, linear light, multiply, screen. Mask support and in-node preview. |
| Frequency Separate | Splits an image into high frequency (texture/detail) and low frequency (color/tone) layers for professional retouching workflows. Two modes: subtract (Photoshop Linear Light style) and divide. Original image pass-through output for easy chaining. |
| Frequency Combine | Recombines edited high and low frequency layers back into a final image. Supports subtract and divide modes to match the separation method used. |
Mask and Background
| Node | Description |
|---|---|
| Remove Background Pro | Advanced AI-powered background removal with 8 rembg models, mask editing tools, multiple preview modes |
| Mask Editor | Stand alone Mask Tools. Refine masks with grow/shrink/blur/fill |
| Apply Mask | Composite image with mask and background options |
| Channel Mask Pro | Extract R/G/B/A channels as separate masks with levels/contrast adjustments and input mask support for advanced Channel Masking |
| Inpaint Mask Pro | Advanced inpaint mask management node. Combines an inpaint mask with an optional silhouette mask and/or SEGS input to crop sloppy inpaint regions to clean boundaries. Features: invert toggle, per-mask blur, mask expand/contract, SEGS support (union/largest), multi-color overlay preview with independent color and opacity per layer (inpaint mask, crop mask, SEGS mask). Outputs: image pass-through, processed mask, B&W mask image, and preview image. |
(examples)
Blending
| Node | Description |
|---|---|
| Image Blend Pro | Blend images with 15 blend modes (normal, overlay, multiply, screen, soft light, hard light, etc.) |
Analysis
| Node | Description |
|---|---|
| Histogram View | Display RGB/luminance histogram in-node for advanced image setting color display |
| Color Wheel View | Display vectorscope color distribution in-node for advanced image setting color display |
(example)
Utilities
| Node | Description |
|---|---|
| Image <> Mask Switch | Convert between IMAGE and MASK types with a toggle. Image-to-mask converts to grayscale using Rec. 601 luma. Mask-to-image expands to 3-channel RGB. |
| Boolean | Output a true/false value |
| Boolean Invert | Flip boolean value (true to false, false to true) for advanced workflow pipeline and settings switching |
| Boolean Switch Value Output | Output different values based on boolean for advanced workflow pipeline and settings switching |
| Boolean Input Value Switch | Route inputs based on boolean for advanced workflow pipeline and settings switching |
| Boolean Master Switch | Control multiple booleans from one switch for controlling multiple switches with one master switch node |
| Seed Lock | Lock/unlock seed values with a toggle to lock the current seed value, opposed to the standard where the following run seed value is locked |
| Text Notes | Add comments and documentation to your workflow for organization |
| Text String | Simple text input node for passing strings to other nodes |
| Show Text | Display and pass through text output from other nodes for debugging |
| Show Value | Display any value type (float, int, string, bool) in the node for debugging |
| Mega Slider Master Value | Master settings (min/max/step) for connected Mega Sliders |
| Mega Slider X1 | Single universal slider with optional master input and per-slider property overrides |
| Mega Slider X3 | 3 universal sliders with optional master input and per-slider property overrides |
| Mega Slider X6 | 6 universal sliders with optional master input and per-slider property overrides |
| Mega Slider X12 | 12 universal sliders with optional master input and per-slider property overrides |
| Dynamic Value Range | Automatically cycles through a value range on each run (increment/decrement/random) |
| Z-Image Empty Latent Image | Empty latent image with Z-Image optimized resolutions from 512x512 to 2048x2048 (landscape, portrait, square) |
(example)
Features
Blur Pro
- 5 blur types in one node with dynamic slider UI that shows only relevant controls per type
- Gaussian — General-purpose smoothing (radius)
- Surface Blur — Edge-preserving bilateral filter for retouching (radius + threshold). Smooths skin/textures while keeping edges sharp.
- Box Blur — Fast stackable blur with iterations for smooth falloff (radius + iterations)
- Median — Edge-preserving noise removal, kills salt-and-pepper artifacts (radius)
- Motion Blur — Directional blur for movement effects (angle + distance)
- Large radius optimization: radii above 30 auto-downscale for fast processing
- Mask input controls where blur is applied, optional mask blurring toggle
- Strength slider to blend blurred result with original
- In-node preview
Noise Grain Pro
- Realistic film grain with independent controls for size, sharpness, and color
- Grain size (0.5-10) — Controls particle size by generating noise at reduced resolution
- Sharpness (0-1) — Grain definition from soft/diffused to crisp
- Monochromatic toggle — Mono grain vs color grain
- Saturation — Color intensity for color grain mode
- 6 industry-standard blend modes: overlay, soft light, hard light, linear light, multiply, screen
- Soft Light uses the correct W3C/Photoshop formula
- Seed input for reproducible grain
- Mask support for selective application
- In-node preview
Frequency Separation
- Professional retouching workflow: split image into texture and color/tone layers
- Frequency Separate — Takes original image + a blurred version (from Blur Pro or any blur node), outputs high frequency (detail), low frequency (pass-through), and original (pass-through)
- Frequency Combine — Recombines edited layers back into a final image
- Two modes: subtract (Photoshop Linear Light style) and divide (fewer artifacts in dark regions)
- Epsilon control for divide mode safety
- Filter-agnostic: use any blur node upstream (Gaussian for standard, Surface Blur for edge-aware retouching)
Inpaint Mask Pro
- Solves the problem of applying external inpaint masks when the Load Image node doesn't accept mask inputs
- Combines an inpaint mask with a clean silhouette mask to crop sloppy inpaint regions
- Invert toggle for flipping the inpaint mask
- Inpaint blur for softening inpaint mask edges
- Mask crop with blur and expand/contract controls for the silhouette mask
- SEGS support from Impact Pack segmentation models (union or largest segment)
- Multi-color overlay preview with independent toggle, color, and opacity per layer:
- Inpaint mask: red, light blue, black, white
- Crop mask: lime green, purple, black, white
- SEGS mask: yellow, orange, black, white
- Dynamic JS UI: settings for each feature only appear when toggled on
- Outputs: image pass-through, processed mask, B&W mask image, colored preview image
Image <> Mask Switch
- Toggle between image-to-mask and mask-to-image conversion
- Image-to-mask: converts RGB to grayscale using Rec. 601 luma coefficients (0.299R + 0.587G + 0.114B)
- Mask-to-image: expands single-channel mask to 3-channel RGB
- Both outputs always populated for stable downstream connections
Curves Adjust Pro
- Interactive curve editor with click-to-add, drag-to-move, shift-click-to-remove points
- Separate RGB, Red, Green, Blue channel curve editing
- 17 built-in presets (S-Curve Contrast, Fade, Cross Process, Cinematic, etc.)
- Visual display of all channel curves in RGB mode
- Mask support with invert option
- Spline interpolation for smooth curves
Color Match Blend
- 3 matching methods: statistical, histogram, reinhard
- 10 blend modes: normal, overlay, multiply, screen, soft light, hard light, color, luminosity, darken, lighten
- Separate luminance and color match controls
- Saturation adjustment
Color Adjust Blend
- Optional color reference input with LAB color matching
- Blend modes for color application
- RGB color balance with shadow/midtone/highlight zones
- Works standalone as simple color balance without reference
LUT Apply
- Supports .cube and .3dl LUT formats
- 5 bundled LUTs included (auto-installed to
ComfyUI/input/luts/):- Cinematic_Teal_Orange
- Warm_Tone
- Cool_Tone
- Vintage_Fade
- High_Contrast
- Intensity slider to blend effect
- Add your own LUTs to
ComfyUI/input/luts/
Remove Background Pro
- 8 AI models: u2net, u2netp, u2net_human_seg, u2net_cloth_seg, silueta, isnet-general-use, isnet-anime, sam
- Built-in mask refinement (grow/shrink, blur, threshold)
- Preview modes: masked, mask only, side-by-side, overlay
- Edge feathering for smooth composites
Channel Mask Pro
- Separates image into R, G, B, Alpha channel masks
- Levels adjustments (black point, white point, gamma)
- Contrast and brightness controls
- Input mask support with invert option
- B&W preview with R/G/B/L labels
Selective Color Pro
- Target specific colors: reds, yellows, greens, cyans, blues, magentas, whites, neutrals, blacks
- CMYK adjustment sliders (-100 to +100)
- Smooth RGB-based color detection for natural results
- Reset All button
- Mask support
Text Notes
- Multiline text area for workflow documentation
- Optional title field
- No inputs/outputs - purely organizational
Text String
- Simple text input with multiline support
- Outputs STRING for connecting to other nodes
Show Text
- Display text output from other nodes
- Pass-through output for chaining
Show Value
- Display any value type (float, int, string, bool) in the node
- Accepts any input type for universal debugging
Mega Slider Master Value
- Set min/max/step values in one place
- Connect to any Mega Slider node to control all its sliders
- One master can connect to multiple slider nodes
- Slider UI updates in real-time when master values change
Mega Slider X1 / X3 / X6 / X12
- 1, 3, 6, or 12 universal sliders with individual outputs
- Optional master input: connect Mega Slider Master Value to apply min/max/step to all sliders
- Per-slider overrides: Right-click node → Properties to set individual
slider_N_min,slider_N_max,slider_N_step - Output as float or integer (toggle)
- Sliders snap to step increments when properties are set
Dynamic Value Range
- Automatically cycles through a range of values on each workflow run
- Modes: increment, decrement, random
- On cycle complete: reverse direction or jump to other end
- Outputs: FLOAT, INT, and STRING versions
- Perfect for creating diversity across batch generations
Z-Image Empty Latent Image
- Pre-configured resolutions optimized for Z-Image model
- Landscape, portrait, and square options from 512x512 to 2048x2048
- Outputs LATENT, WIDTH, and HEIGHT for flexible workflow connections
- Configurable batch size
Changelog
v2.1.0
- New Node: Blur Pro — 5 blur types (Gaussian, Surface, Box, Median, Motion) with dynamic UI, mask support, strength blending, large radius optimization, in-node preview
- New Node: Noise Grain Pro — Film grain generator with size, sharpness, color/mono, saturation, 6 blend modes, seed, mask support
- New Node: Frequency Separate — Split image into high/low frequency layers for professional retouching
- New Node: Frequency Combine — Recombine frequency layers with subtract/divide modes
- New Node: Inpaint Mask Pro — Advanced inpaint mask management with mask cropping, SEGS support, multi-color overlay preview
- New Node: Image <> Mask Switch — Toggle conversion between IMAGE and MASK types
- New Category: Filters (Blur Pro, Noise Grain Pro, Frequency Separate/Combine)
v2.0.5
- Fix: Updated pyproject.toml version to match release
- Fix: Corrected node count
v2.0.4
- New Node: Z-Image Empty Latent Image with optimized resolutions for Z-Image model
v2.0.3
- New Nodes: Show Value, Mega Slider Master Value, Mega Slider X1/X3/X6/X12, Dynamic Value Range
- Mega Slider Master Value: Set min/max/step for connected Mega Sliders
- Mega Sliders: Universal slider banks with optional master input and per-slider settings via right-click → Properties
- Dynamic Value Range: Auto-cycling values for batch diversity (increment/decrement/random modes)
- Show Value: Display any value type in-node for debugging
v2.0.2
- New Nodes: Text Notes, Text String, Show Text utility nodes
- Organized Categories: Nodes now grouped into subcategories (Color, Mask, Blend, Analysis, Util)
v2.0.1
Updated Node Settings, Resolved Display Issues, Fixed Several Node structures.
v2.0.0
Major Overhaul, Node Additions, and Improvements
- New Nodes: LUT Apply, Channel Mask Pro, Selective Color Pro, Boolean Invert
- Bundled LUTs: 5 color grading LUTs included with auto-install
- Curves Adjust Pro: Added mask support, improved curve display showing all channels in RGB mode
- Channel Mask Pro: Added input mask support, levels/contrast adjustments, improved B&W preview
- Unified Category: All nodes now appear under single "MachinePaintingNodes" folder
- Selective Color Pro: Added Reset All button
- Analysis Nodes: Improved auto-scaling for Histogram and Color Wheel views
- Code Cleanup: Removed deprecated nodes, standardized categories
v1.0.0
- Initial release with color adjustment, blending, and boolean utility nodes
License
MIT License - See LICENSE for details.
Want to Auto Send your ComfyUI files from output folder to your Google Drive or Dropbox Account?
Check out these new Nodes to advance your Ai workflows. Super helpful tools to protect your creations and streamline your process. DriveSend and DropSend node with optional file Encryption.
Tags
comfyui comfyui-nodes custom-nodes color-grading color-correction curves levels lut lookup-table photoshop image-processing image-editing background-removal rembg masking mask-editor channel-mixer histogram vectorscope blend-modes compositing stable-diffusion ai-art generative-art film-emulation cinematic color-matching hsl cmyk selective-color boolean-logic workflow utilities sliders dynamic-values blur gaussian-blur surface-blur motion-blur bilateral-filter film-grain noise frequency-separation retouching inpainting segs