ComfyUI Extension: RGBYP Mask Editor (RGB + YP)

Authored by akawana

Created

Updated

0 stars

A JS editor for five-color masks (RGB + Yellow + Pink) that works with any nodes, with three helper nodes — RGBYPLoadImage, RGBYPMaskBridge, and RGBYPMaskToRegularMasks—for convenient RGBYP mask handling.

Custom Nodes (0)

    README

    Other My Nodes

    Utilities for working with Lists and toggling groups

    https://github.com/akawana/ComfyUI-Utils-extra

    Extra shortcuts for editing texts and prompts + text splitting for Regional Prompts

    https://github.com/akawana/ComfyUI-Keybinding-extra

    RGBYP 5-color mask editor

    https://github.com/akawana/ComfyUI-RGBYP-Mask-Editor

    ComfyUI-RGBYP-Mask-Editor

    RGB + Yellow + Pink 5-color mask editor for ComfyUI

    Overview

    RGBYP Mask Editor is a custom JavaScript node that adds a full-featured color mask editor with 5 channels (RGB + Yellow + Pink).

    The node saves its working files inside /ComfyUI/temp/ and some in /ComfyUI/input/rgbyp/, which allows masks to persist even after refreshing the browser page.
    ⚠️ All files inside /temp/ are automatically cleared when you restart ComfyUI. ⚠️ All files inside /input/rgbyp/ can be deleted.

    The editor works on any image node (Load Image, Preview, etc.), but the package also includes special nodes that directly output RGBYP masks as separate images:

    • LoadImageWithFileData
    • RGBYPMaskBridge
    • RGBYPMaskToRegularMasks

    RGBYP Mask Editor

    The editor opens from the Right-Click menu on nodes containing images.
    The menu entry appears near the top.

    <img src="preview_menu.jpg" />

    Keyboard Shortcuts

    • 1, 2, 3, 4, 5 — switch color. Also works with SHIFT+number
    • SHIFT + A / D — brush size
    • SHIFT + W / S — mask opacity
    • SHIFT + Z / X — zoom
    • SHIFT + C — zoom to fit
    • SHIFT + N — clear mask
    • SHIFT + V — auto masking
    • SHIFT+SPACE (hold) — pan the image. Also without SHIFT.
    • ENTER — save mask & close
    • ESC — cancel & close

    Mouse Controls

    • Left click — brush
    • Right click — eraser
    • Middle click — pan
    • Mouse wheel — zoom

    Opacity Note

    Changing opacity only affects the preview, including previews in nodes.
    It does not affect the final mask file.
    Default opacity is 75%.

    Auto-Mask Tools (4 buttons)

    Fill the mask horizontally:

    • Split in half
    • Split 1:2
    • Split 2:1
    • Split into thirds
    <img src="preview_editor.jpg" width="100%"/>

    RGBYPLoadImage

    A standard image-loading node that also outputs the RGBYP mask (or a 64×64 black placeholder if no mask was drawn).

    Additional outputs:

    • file_path — full path excluding filename
    • file_name — filename without extension

    RGBYPMaskBridge

    Passes the input image through and allows drawing an RGBYP mask directly on it.
    Outputs both the image and the mask.

    This node includes a parameter: clear_on_size_change

    • false – the previous mask is always preserved and will be applied to any new input image, even if the new image has a different resolution.
      This is the recommended mode. You can manually clear the mask in the editor when needed.

    • true – the mask will be cleared (destroyed) whenever the input image size changes.

    Important: updater widget

    ⚠️ Do not touch the updater widget.

    • It is used only for internal editor logic.
    • Do not change its value.
    • Do not connect anything to it.
    • Just ignore it in your graphs.

    RGBYPMaskToRegularMasks

    Converts a single RGBYP mask image into five separate grayscale masks.
    A minimalistic utility for quick splitting.

    F.A.Q.

    Can I draw masks on regular Load Image and other nodes?

    Yes, but keep in mind:

    1. They output the image with the mask baked in, not the mask itself.
    2. Your mask edits will be lost if you refresh the browser.
      (My nodes preserve masks because they store temp files.)

    How do I keep my mask after a full ComfyUI restart?

    The RGBYP mask is just an image.
    Save the generated mask manually to your output folder and load it again in the next session.

    If you use the standard ComfyUI nodes, you will get a baked image with the mask already applied. This means that when splitting by colors, you may end up with dirty or contaminated areas on the masks. <img src="preview_regular_node.jpg" width="100%"/>

    If you use my RGBYP Load Image node, you will have a separate output for the RGBYP mask, and the color separation will be clean. <img src="preview_loader.jpg" width="100%"/>

    RGBYP Mask Bridge is designed for more complex workflows. You can feed any image into it, edit the mask, and the rgbyp_mask output will give you a clean mask. <img src="preview_bridge.jpg" width="100%"/>

    Installation

    You can install this extension in two ways:

    1. Through ComfyUI Manager (recommended)

    Open ComfyUI Manager ? Install,
    then simply search for RGBYP in the search bar.
    Select the extension and click Install.

    2. Manual installation

    cd ComfyUI/custom_nodes
git clone https://github.com/akawana/ComfyUI-RGBYP-Mask-Editor.git