🦊 ComfyUI_RaykoStudio
Set of custom nodes for ComfyUI providing additional image processing capabilities
Nodes do not require the installation of additional Python packages.
Performance has been tested for:
- ComfyUI 0.15*-0.18*
- Python 3.10-3.13
- Torch 2.8-2.10
- Cuda 12.4-13.0
🛠 Installation
Set of nodes can be installed in several ways:
- Clone repository to
ComfyUI/custom_nodes/folder:
git clone https://github.com/Raykosan/ComfyUI_RaykoStudio.git
- Copy ComfyUI_RaykoStudio folder to: ComfyUI/custom_nodes/
- You can install this node using the ComfyUI_Manager
🦊 RS Outpaint node
Interactive visual mask selection for outpainting/inpainting workflows
🔥 Features
- Visual Mask Editor — Drag, resize, and position the crop area directly on the image preview
- Pause & Approve — Workflow pauses after first execution, waiting for your confirmation
- Grid Snapping — All dimensions snap to 16px grid for clean, model-friendly outputs
- Aspect Ratio Lock — Toggle to preserve crop proportions while resizing
- Quick Presets — One-click aspect ratios: 16:9, 9:16, 21:9, 4:3, 1:1, and more
- Smart Snapping — Align crop to center, edges, or fit source dimensions
- Output Resolution Control — Set target resolution with optional upscaling/downscaling
- Zoom & Pan — Navigate large images with mouse wheel and middle-drag
- Color mask and Background — Selecting the color for the mask and background when using the mask_image output
- Padding Indicators — Visual labels show generated padding areas (▲▼◀▶)
- Keyboard Shortcuts — Arrow keys to nudge crop box (Shift for 4× step)
🪛 Usage
Basic Workflow
First Execution: Node pauses and displays interactive canvas
Adjust Mask:
Drag the blue-bordered box to reposition
Use corner/edge handles to resize
Toggle 🔒 to lock/unlock aspect ratio
Select preset ratios or snap to position
Set Output Resolution (optional): Leave at 0 for auto, or specify target W×H
Select the colors for the mask and background, and you will use the mask_image output.
Click ✔️ ACCEPT to continue generation with your mask
↔️ Inputs and Outputs:
Input :
image - Source image for outpainting
Output :
control_image - Image with masked area (gray padding where generation will occur)
control_mask - Binary mask: 0 = keep original (black), 1 = generate new content (white)
mask_image - Makes an image from a mask
width - Final output width (after optional resize)
height - Final output height (after optional resize)
🦊 RS Spline Mask node
Node for creating a spline mask
🔥 Features
The node is designed to create masks without using the ComfyUI native editor. More accurate selection based on the principle of the Lasso tool from Photoshop.
🪛 Usage
The node is ready for use immediately after it is added. Images are added using the "🎨 IMAGE" (images from the input folder) and "🖼️ UPLOAD IMAGE" (images from any folder on your PC) buttons. You can scale the node to a convenient size to more accurately place the points of the spline. Incorrectly positioned points can be deleted by right-clicking on them. To remove all points from the preview area, click the "🔴 CLEAR POINTS" button.
↔️ Inputs and Outputs:
The IMAGE output returns the original image unchanged. The MASK output returns a black and white mask where the white area corresponds to the drawn polygon.
🦊 RS Intermediate Spline Mask node
An interactive node for creating intermediate spline masks
🔥 Features
Node allows you to pause the workflow at the image processing stage, manually select the desired area and continue generation without completely restarting the process. More accurate selection based on the principle of the Lasso tool from Photoshop.
🪛 Usage
When this node is reached, pipeline execution is automatically suspended. A preview of the input image is displayed in the node's interface. The user can left-click to add polygon points and right-click or Ctrl-click to delete the last points.
The "✔️ ACCEPT" button confirms the created mask, after which the node completes processing and transmits the data further according to the scheme. The "🔴 CLEAR POINTS" button clears all the drawn points for redrawing. It is important that after using this button, you do not need to press the Prompt Queue again, just draw a new mask and press "✔️ ACCEPT". The "❌ CANCEL" button completely interrupts the process and resets the node status.
↔️ Inputs and Outputs:
The IMAGE input accepts an image from any previous node. The IMAGE output returns the original image unchanged. The MASK output returns a black and white mask where the white area corresponds to the drawn polygon.
🦊 RS Image Selector node
Node for Interactive Batch Image Selection
🔥 Features
- Interactive Grid View - Display all batch images in a responsive grid layout
- Multi-Select Support - Click to select/deselect individual images
- Smart Auto-Resize - Node automatically adjusts size based on image count
- Heartbeat System - Robust connection monitoring between frontend and backend
- Auto-Cleanup - Proper resource cleanup on node removal or workflow close
🪛 Usage
Buttons
➕ SELECT ALL - Select all images in batch
⭕ DESELECT ALL - Clear all selections
✔️ ACCEPT - Confirm selection and continue
❌ CANCEL - Cancel and interrupt generation
Continue Workflow
Click "✔️ ACCEPT" to pass selected images to next nodes. Only selected images will be processed downstream
⚠️ Reminder
The generation process will pause indefinitely until you click "❌ CANCEL" or close the workflow or the ComfyUI page.
🦊 RS Crop Image node and 🦊 RS Insert Crop node
An interactive node for selecting and cropping images in ComfyUI with a pause in the process. With further insertion of the cut fragment after its modification back into the original image.
🔥 Features
🦊 RS Crop Image is an interactive node for ComfyUI that allows you to select a rectangular area in an image using drag-and-drop before continuing workflow.
Unlike standard crop nodes, this node suspends the process and waits for user confirmation, which gives full control over the cropping area.
- Drag-and-Drop - Selecting an area with the mouse directly in the interface
- Resizing - Stretching the frame by the corners
- Moving - Dragging the selected area
- Process pause - Workflow waits for confirmation before continuing
- Visualization - Real-time area size display
- Crop Data - Output of exact cutout parameters
🦊 RS Insert Crop is a node that allows you to seamlessly insert a previously cut fragment back into the original image after it has been modified by the workflow nodes.
- Crop Data - Inserting a fragment into the original image using the previously obtained precise cutout parameters.
🪛 Usage
🦊 RS Crop Image
Connect any image to the IMAGE input. Select an area:
- LMB + Drag - Create a new selection area
- Drag inside the frame - Move the area
- Drag around the corners - Change the size of the area
Click the button:
✔️ ACCEPT - Confirm the allocation and continue workflow
🔄 RESET - Reset the selection and select again
❌ CANCEL - Cancel and interrupt generation
🦊 RS Insert Crop
Connect the original image to the Original Image input.
Connect the embedded and modified fragment to the Cropped Image input.
Connect the node with the text Crop Data.
⚠️ Reminder
The generation process will be suspended indefinitely until you click "✔️ ACCEPT", "❌ CANCEL" or close the workflow or the ComfyUI page.
🦊 RS Styles Loader node
Node for uploading and managing styles from CSV files
🔥 Features
- Download CSV files - Upload your files with styles directly through the interface
- Tree structure - Styles are organized by folders (categories)
- Visual selection - User-friendly interface with drop-down lists
- Bypass styles - Turn styles on/off without deleting them from the list
- Combining - Multiple styles are combined into one prompt
- Save to workflow - All settings are saved along with the project
🪛 Usage
Buttons
SELECT CSV FILE - Select the desired CSV file from the list of files that you have already uploaded earlier.
📂 UPLOAD NEW CSV FILE - Download a new CSV file from anywhere on your PC. It will automatically appear in the styles folder and in the future you will be able to select it with the "SELECT CSV FILE" button.
➕ ADD STYLE - Choosing the styles you need
🟢 - Bypass on/off. You can choose an infinite number of styles and change them to create the combination you need.
❌ - Removing a style from the panel
🎨 Styles
You can use your own styles or find them in the ComfyUI community
For example:
https://github.com/vaulthunt3r/ComfyUI-Style-Prompts-Collection
https://github.com/Art-xmaster/comfyui-AGSoft/tree/main/styles
⚠️ Notes
The styles folder is created automatically at the first startup.
When deleting a node from workflow, the uploaded CSV files are not deleted.
To update the list of files after adding CSV manually, restart ComfyUI.
🦊 RS Last Frame node
A lightweight ComfyUI node that extracts the last frame from any video input.
🔥 Features
- Universal Input Support — Accepts native VideoFromFile objects (ComfyUI's built-in video loader), standard IMAGE tensors (VHS, Image Batch), and dictionary formats
- Zero Dependencies — Works out-of-the-box without requiring Video Helper Suite or other external libraries
- Automatic Format Detection — Intelligently handles different tensor dimensions [F, H, W, C], [B, F, H, W, C], or channel-first formats
- Memory Efficient — Extracts frames without unnecessary copying or conversion
🪛 Usage
If video has only 1 frame, that frame is returned unchanged
Automatically handles batched inputs by taking the first batch element
Channel permutation applied automatically if decoder outputs [F, C, H, W]
Compatible with ComfyUI v1.0+ and all major video loading extensions
↔️ Input and output:
Input: video_frames (* — Universal)
Accepts:
- IMAGE tensor from VHS loaders, Image Batch, or standard image nodes
- VideoFromFile object from ComfyUI's native Load Video node
- Dictionary with frames, images, or video keys
Output: IMAGE (torch.Tensor)
Single frame tensor with shape [1, H, W, C] — ready for VAE encoding, preview, or any image processing node.
🦊 RS Models Loader node
Combined node for loading models
🔥 Features
The node combines the loaders of the Model, Clip,VAE and LoRA. If you have downloaded a new LoRA, then you do not need to update the ComfyUI or the page - there is a button to update the LoRA list.
Link to the video: https://youtu.be/LxhVk5C_oas
🦊 RS Text Overlay node
Node allows you to overlay text on images using masks
The node is in the process of feature improvements, but the stated functionality is already working
🔥 Features
- Automatic font size selection — the text always fits perfectly into the mask area
- Text rotation by mask — the text is automatically aligned to the angle of the mask
- Multiline text support — automatic line splitting
- Vertical and horizontal text orientation - you write vertical text by typing one letter in each line
- Adjusting the letter and line spacing
- Text outline — customizable thickness and color
- Shadow — adjustable displacement, blurring and transparency
- Glow — adjustable color, size, area and brightness
- Color — HEX format support (#RRGGBB or #RRGGBBAA)
- Text transparency — independent of stroke and shadow
- Supersampling — rendering text in increased resolution followed by compression for perfect smoothing
- Edge Smoothing — additional smoothing of text edges
- High-quality interpolation - Lanczos filter when zooming
- Caching — fonts, colors, sizes, and rendered layers
- LRU cache — automatic memory management
- Optimized outline rendering — 8-direction algorithms
🔤 Installing Fonts
Place the font files in the fonts folder (.ttf, .otf, .ttc)
Restart ComfyUI
🪛 Usage
| Parameter | Description | Range |
|---|---|---|
| TEXT | Text to display (supports multiline) | |
| FONT | List of available fonts | |
| TEXT COLOR | Color text in HEX format | #000000 - #FFFFFF |
| OUTLINE THICK | Outline thickness | 0 - 50 |
| OUTLINE COLOR | Outline color in HEX format | #000000 - #FFFFFF |
| ROTATE WITH MASK | Rotate text by the angle of mask | ON/OFF |
| TEXT OPACITY | Text transparency | 0.0 - 1.0 |
| LINE SPACING | Line spacing | 0.5 - 3.0 |
| LETTER SPACING | Letter spacing | -20 - +100 |
| ENABLE GLOW | Enable glow | ON/OFF |
| GLOW COLOR | Color glow in HEX format | #000000 - #FFFFFF |
| GLOW SIZE | Glow size | -500 - +500 |
| GLOW SPREAD | Area of the glow | 0 - 500 |
| GLOW BRIGHTNESS | Brightness of the glow | 0.0 - 1.0 |
| ENABLE SHADOW | Enable shadow | ON/OFF |
| SHADOW COLOR | Shadow color in HEX format | #000000 - #FFFFFF |
| SHADOW OFFSET X/Y | Shifting the shadow | -500 - +500 |
| SHADOW BLUR | Blurring the shadow | 0.0 - 1.0 |
| SHADOW BRIGHTNESS | Brightness of the shadow | 0.0 - 1.0 |
| SUPERSAMPLING | Enable supersampling | ON/OFF |
| SUPERSAMPLE FACTOR | Magnification factor | 2 - 4 |
| EDGE SMOOTHING | Smoothing the edges | ON/OFF |
🦊 RS Saturation node
Professional image saturation control with artifact and highlight protection.
🔥 Features
- Smooth adjustment with 0.05 steps
- Smart boosting without overexposure
- Artifact protection even at extreme values
- Batch processing optimized
🪛 Usage
| Range | Processing Type | Use Case |
|---|---|---|
| 0.0-0.9 | Toning/desaturation | Gradual color removal |
| 1.0-1.3 | Natural enhancement | Recommended range |
| 1.3-2.0 | Vibrant artistic effects | Stylization |
| 2.0-3.0 | Maximum saturation | Cinematic effects |
⚙️ Technical Details
Algorithm workflow:
Luminance space conversion
Non-linear adjustment:
Values <1.0: Linear interpolation
Values >1.0: Adaptive S-curve
Auto highlight recovery
🦊 RS Save Image node
Node for adding explanatory text to an image
🔥 Features
The node is used to save the image while preserving the workflow inside the image. You can add explanatory text to an image with a choice of background size, theme, font and its size. It is possible to add your own fonts (to the fonts folder). Use ttf and otf fonts.
If the label is not needed, leave the text field blank and the image is saved as usual.
Themes:
light - white background, black text.
dark - black background, white text.
🦊 RS Save Image Pair node
The node is used to save the original and final images in a single image, while maintaining the workflow within the image
🔥 Features
The node is used to save the source and final images in a single image while maintaining the workflow within the image. You can add explanatory text to any image with a choice of background size, theme, font and size font. A reverse upscale from 1 to 0 is provided to reduce the saved image (if it is used as a sketch with a workflow inside).
It is possible to add your own fonts (to the fonts folder). Use ttf and otf fonts.
If the label is not needed, leave the text field blank and the image is saved as usual.
The node is convenient for visual understanding of the workflow contained in the image.
🪛 Usage
It is better to choose horizontal saving for portraits, and vertical saving for landscapes.
Themes:
light - white background, black text.
dark - black background, white text.
🦊 RS Image-Text node
Node embeds any hidden text into the image that can be used later
🔥 Features
The node writes any hidden text to any png and jpeg file (jpeg is converted to png). And outputs text from images recorded in this way. You can use it instead of a Load Image (without a mask) and transfer the recorded text to the promt node. It is useful if there is an image and a prompt to it, but the image does not contain a workflow (often found on the site civitai.com).
🪛 Usage
Two modes:
Write - writes text to the uploaded image and saves it to the output folder with the prefix you specified.
Read - reads the text you wrote earlier in the uploaded image, sends the text and images further according to the scheme.
Link to the video: https://youtu.be/1s26hUcVXX4
🦊 RS Loop Switch node
A combined node for generating a sequence of values with automatic switching
🔥 Features
The node generates a list of INT values, automatically switching between 10 preset values based on the current cycle step. It is ideal for generating a series of images with different seeds without the need to manually change the parameters. But you can use it for any other tasks where dynamic INT changes are required.
🔌 Connection (examples)
- RS Loop Switch (output) → KSampler (seed)
- RS Loop Switch (output) → KSampler (steps)
- RS Loop Switch (output) → any INT input
🤝 Bug Reporting
If you encounter an issue or find a bug:
Check Issues section on GitHub, maybe problem is already known.
If new problem, create new Issue describing:
- ComfyUI and Python versions
- Problem description and reproduction steps
- Screenshots or error logs (if available)
📜 License
MIT License. Use node at your own risk without any warranties.
❤️ Acknowledgments
Thanks to ComfyUI community for inspiration and support! If you like this node, don't forget to star on GitHub!