Extensions/ComfyUI-NKD-Basic-Tools
ComfyUI Extension

ComfyUI-NKD-Basic-Tools

A ComfyUI extension with 25 custom nodes.

By Nekodificador·Created about a month ago·Updated 3 days ago· 71
Nekodificador/ComfyUI-NKD-Basic-Tools
Nodes25
On cloudLocal install
Category😺NKD Nodes/Masking, 😺NKD Nodes/Basic
Stars71
Updated3 days ago

Nodes (25)

😺NKD Audio Mask

The audio-branch mask that only regens the part of the clip you asked for

😺NKD Nodes/Masking
😺NKD AV Latent

Picture and sound in, one masked AV latent out — without a six-node chain

😺NKD Nodes/Masking
😺NKD AV Latent Extend

Build a long MiniMax H3 take out of short clips, sound staying in sync

😺NKD Nodes/Masking
😺NKD Color Warp

Grade by grabbing the colors themselves, then export it as a .cube LUT

😺NKD Nodes/Basic
😺NKD Face Crop

Upright, square, tightly framed

😺NKD Nodes/Face
😺NKD Face Mask

A face mask from landmarks, no segmentation model, no extra download

😺NKD Nodes/Face
😺NKD Face Rig

Pose a portrait's expression by dragging handles on the face itself

😺NKD Nodes/Face
😺NKD Face Stitch

Put the processed face back at its original angle — the detailer's invisible partner

😺NKD Nodes/Face
😺NKD Field Blur

Fake a shallow depth of field with pins, no depth map required

😺NKD Nodes/Basic
😺NKD Film Grain

Film grain that shimmers on video instead of sitting frozen on top

😺NKD Nodes/Basic
😺NKD Frequency Combine

Put skin texture back after a relight — the detail-transfer finisher

😺NKD Nodes/Basic
😺NKD Frequency Separate

Split an image into soft base and fine detail — the relight rescue

😺NKD Nodes/Basic
😺NKD Gradient Generate

Build a gradient from scratch — as a background, a mask, or a light leak

😺NKD Nodes/Basic
😺NKD Gradient Map

Recolor by brightness — instant duotones, teal-orange, and filmic grades

😺NKD Nodes/Basic
😺NKD Inpaint Crop

Detail one region without re-rendering the rest — crop to the mask's budget

😺NKD Nodes/Basic
😺NKD Inpaint Stitch

Composite the regenerated region back at full resolution, seam invisible

😺NKD Nodes/Basic
😺NKD Mask Ops

The whole mask pipeline in one GPU pass — levels, specks, holes, blockify, temporal

😺NKD Nodes/Masking
😺NKD Mask Ops Lean

Fill holes, expand, feather — the three mask tweaks a composite needs

😺NKD Nodes/Masking
😺NKD Mask Painter

Stop duplicating Load Image just to draw a mask — NKD Mask Painter paints on any IMAGE

😺NKD Nodes/Masking
😺NKD MiniMax Guides

Every MiniMax H3 guide from one node, instead of a row of spaghetti

😺NKD Nodes/Conditioning
😺NKD Noise

Fractal noise for clouds, fog and smoke — image and mask, loopable

😺NKD Nodes/Basic
😺NKD Path Blur

Draw the movement, the image smears along it

😺NKD Nodes/Basic
😺NKD Prompt Variables

Variable chips that turn a prompt into a batch

😺NKD Nodes/Basic
😺NKD String Split

Split your LLM's list into generations

😺NKD Nodes/Basic
😺NKD Vector Mask

A pen tool, Bezier and B-spline, live in your workflow

😺NKD Nodes/Masking
Readme

😺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 ultralytics is installed.

Work this builds on

  • MaskVidExperiments — its Mask To Latent Space node 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_BasicMaskedExtension is 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