ComfyUI-NKD-Basic-Tools
A ComfyUI extension with 25 custom nodes.
Nodes (25)
The audio-branch mask that only regens the part of the clip you asked for
Picture and sound in, one masked AV latent out — without a six-node chain
Build a long MiniMax H3 take out of short clips, sound staying in sync
Grade by grabbing the colors themselves, then export it as a .cube LUT
Upright, square, tightly framed
A face mask from landmarks, no segmentation model, no extra download
Pose a portrait's expression by dragging handles on the face itself
Put the processed face back at its original angle — the detailer's invisible partner
Fake a shallow depth of field with pins, no depth map required
Film grain that shimmers on video instead of sitting frozen on top
Put skin texture back after a relight — the detail-transfer finisher
Split an image into soft base and fine detail — the relight rescue
Build a gradient from scratch — as a background, a mask, or a light leak
Recolor by brightness — instant duotones, teal-orange, and filmic grades
Detail one region without re-rendering the rest — crop to the mask's budget
Composite the regenerated region back at full resolution, seam invisible
The whole mask pipeline in one GPU pass — levels, specks, holes, blockify, temporal
Fill holes, expand, feather — the three mask tweaks a composite needs
Stop duplicating Load Image just to draw a mask — NKD Mask Painter paints on any IMAGE
Every MiniMax H3 guide from one node, instead of a row of spaghetti
Fractal noise for clouds, fog and smoke — image and mask, loopable
Draw the movement, the image smears along it
Variable chips that turn a prompt into a batch
Split your LLM's list into generations
A pen tool, Bezier and B-spline, live in your workflow
😺NKD Basic Tools
A grab-bag of everyday ComfyUI nodes that take the wiring and the busywork out of the way: detail an inpaint at the right resolution, roto a mask by hand with a pen tool, fake a shallow depth of field or a motion blur that curves, put skin texture back after a relight, recolor by brightness, make procedural noise or film grain, turn one text box into a whole batch of prompts.
Most of them preview inside the node, so you tune while you look, and most of those update without running the graph at all.
Each node has its own page. Pick the one you need.
Detailing & inpainting
Cut a piece out, work on it at the right resolution, put it back invisibly. Plus everything that gets a mask ready for the job.
https://github.com/user-attachments/assets/84e20b72-be4d-4dd6-84d7-69ae7f889dd7
| Node | What it does | |---|---| | 😺NKD Inpaint Crop / Stitch | Fixes one part of an image without re-rendering the rest. Crops the masked area at your sampler's resolution and puts it back at full size, no seam. | | 😺NKD Frequency Separate / Combine | Splits an image into a soft base and a detail layer. The usual job is putting skin and fabric texture back after a relight. | | 😺NKD Mask Ops | A whole mask pipeline in one node: levels, specks, holes, expand, feather, blockify, temporal steps. Whole batch, one trip to the GPU. | | 😺NKD Mask Ops Lean | The three a composite actually needs, fill holes, expand/contract and feather, at the same speed. | | 😺NKD AV Latent | Inpaints a video that carries its own soundtrack (MiniMax H3, LTXV) without the sound being regenerated behind your back. | | 😺NKD AV Latent Extend | Continues a sampled clip into a new one, picture and sound together, so a long take can be built out of short stages. | | 😺NKD Audio Mask | Masks the audio branch on its own, fitted to the soundtrack's real timing. | | 😺NKD MiniMax Guides | Every guide of a MiniMax H3 shot from one node, instead of a row of them each dragging the same four cables across the canvas. | | 😺NKD Mask Painter | Paints a mask onto an image your graph just made, and stacks masks from anywhere while the result stays paintable. | | 😺NKD Vector Mask | Roto by hand with a pen tool. What gets saved is control points, so it's still editable next week. |
Faces
Frame a face the way models want it, or pose its expression by hand.
https://github.com/user-attachments/assets/97beddd1-99ca-475d-97b8-e0d2115fef28
| Node | What it does | |---|---| | 😺NKD Face Rig | Poses an expression by dragging handles on the face itself: brows, eyelids, gaze, mouth, jaw, head. Re-renders as you drag. | | 😺NKD Face Crop / Mask / Stitch | Hands a face to a model upright, square and tightly framed, then puts the result back at the angle it came from. |
Blur
Blur that follows something: the shape of a movement, or the depth of a scene. Both are drawn on the image and previewed with the real render.
<!-- hero video goes here -->| Node | What it does | |---|---| | 😺NKD Path Blur | Motion blur that curves, instead of the one straight angle a normal motion blur gives you. | | 😺NKD Field Blur | A shallow depth of field without a depth map. Drop pins, set how much blur each wants, the rest is interpolated. |
Color & gradients
Push the colors that are already there, or map new ones onto the image by brightness.
https://github.com/user-attachments/assets/909d881d-3b09-41d2-88ba-aff797db9898
| Node | What it does |
|---|---|
| 😺NKD Color Warp | Grades by grabbing the colors themselves, on a wheel your own image is scattered across. Exports the grade as a .cube LUT. |
| 😺NKD Gradient Map / Generate | Recolors a photo by brightness, or builds a gradient from scratch as a background, a mask or a light leak. |
Textures
Put the noise back. Grain that moves like emulsion, and fractal noise to build clouds, fog and smoke out of nothing.
https://github.com/user-attachments/assets/250a156d-e95d-499d-8a18-61454e95802f
| Node | What it does | |---|---| | 😺NKD Film Grain | Analog grain that holds up. Fresh grain per frame on a video batch, so it shimmers instead of sitting frozen on top. | | 😺NKD Noise | Fractal noise (fBm) for clouds, fog and smoke, as an image and a mask, with seamless looping animation. |
Prompt & text utilities
One text box in, a whole batch of prompts out.
https://github.com/user-attachments/assets/ce3f916a-3a41-4848-be44-9636dc7477bb
| Node | What it does | |---|---| | 😺NKD String Split | Turns one block of text into a batch. A list of prompts becomes N generations with no extra wiring. | | 😺NKD Prompt Variables | Drop variable chips into your prompt and feed each one from a socket or a list. |
Credits
Shipped with the pack
- LivePortrait (MIT, Kuaishou Visual
Generation and Interaction Center) is vendored under
nkd_liveportrait/and does the rendering in 😺NKD Face Rig. - Vue (MIT) is bundled into the node widgets.
- YuNet (MIT), from OpenCV's model zoo, is the face detector the crop nodes download on first use.
- Bingsu/adetailer hosts the YOLOv8
face model the crop asks for instead when
ultralyticsis installed.
Work this builds on
- MaskVidExperiments — its
Mask To Latent Spacenode is where the idea of handing the sampler a mask already in latent space comes from, and the conversation around it is what turned up both the frame-grouping and the token-grid behaviour that 😺NKD Mask Ops now handles. - differential-diffusion — the soft-mask denoise schedule 😺NKD Inpaint Crop applies inline, same behavior as core's DifferentialDiffusion node.
- Ablejones — 😺NKD AV Latent Extend is their masked-extension workflow
collapsed into one node, and their
MiniMaxH3_BasicMaskedExtensionis the fixture its tests are checked against.
Inspiration
- VRGamedevgirl's FastFilmGrain and radiance — between them, why 😺NKD Film Grain shimmers on a video batch instead of sitting frozen on top.
- KJNodes — the mask nodes everyone reaches for first, and the bar 😺NKD Mask Ops had to clear.
- rgthree-comfy — its widgets are why the buttons in 😺NKD Mask Painter sit where they do.
License
MIT