comfyui-darkil-nodes

Custom ComfyUI Nodes

Languages: English · Русский

This repository contains custom nodes for ComfyUI that extend functionality for workflows.

Available Nodes

Text Processing Nodes

1. Variable builder [darkilNodes]

• Category: darkilNodes/text
• Description: Builds text variables from multiple inputs with configurable formatting.
• Features:
  • Supports multiple input types (text, integers, floats)
  • Configurable separators and prefixes/suffixes
  • Conditional output based on input presence
• Inputs:
  • switch (BOOL): node active toggle
  • out_val_by_switch (BOOL): return if active
  • var_name (STRING): variable name
  • var_value (STRING): variable value
  • INPUT_VAR (STRING): other variables input

2. Advanced variable builder [darkilNodes]

• Category: darkilNodes/text
• Description: Advanced text variable builder with complex formatting options.
• Features:
  • Supports multiple input types with custom formatting
  • Configurable separators and prefixes/suffixes
  • Conditional output based on input presence
  • Customizable number formatting for integers and floats
• Inputs:
  • switch (BOOL): node active toggle
  • out_val_by_switch (BOOL): return if active
  • var_name (STRING): variable name
  • var_text (STRING): variable value
  • INPUT_VAR (STRING): other variables input
  • DYNAMIC_* (STRING): dynamic inputs
  • condition (BOOLEAN): When True, outputs only if inputs are present
  • int_format (STRING): Format string for integers
  • float_format (STRING): Format string for floats

3. Dynamic prompt builder [darkilNodes]

• Category: darkilNodes/text
• Description: Builds prompts from a small template language. Placeholders and toggle tags written in the prompt text spawn matching widgets on the node, so one prompt can be reconfigured live without editing the text.
• Features:
  • Placeholders {{NAME:TYPE:VALUE:DEFAULT:USE_INPUT}} create dynamic widgets. TYPE = STRING, INT, FLOAT, COMBO, SLIDER, KNOB; USE_INPUT (true) exposes an input socket for the value.
  • Toggle tags [[TAG]]…[[/TAG]] keep or drop the wrapped block via a per-tag switch. [[TAG:GROUP]] makes tags sharing a GROUP mutually exclusive (radio behavior). Tags can be nested.
  • Extra block [%extra%]…[%/extra%] is compiled to a second output; Vars block [%vars%]…[%/vars%] is ignored by the backend (a notes/scratch area).
  • Comments removed before processing: // …, # …, /* … */.
  • Spaceless blocks {%spaceless%}…{%spaceless stop%} collapse whitespace, and formatting directives (lower, upper, title, sentence, trim, dedent, list, list_and, …) transform the wrapped text and can be nested.
  • Syntax-highlighting editor: color highlighting, an Insert / Vars menu, caret-context hints, validation underlines, and keyboard autocomplete (EN/RU localized).
  • Compact switch bar: three inline switches on one row — EDITOR (show/hide the editor), PROMPT (process the main prompt), EXTRA (process the extra block).
• Inputs:
  • prompt (STRING, multiline): the prompt template with placeholders, tags, blocks and directives
• UI switches (client-side, one compact row):
  • EDITOR: show/hide the prompt editor widget
  • PROMPT: enable/disable processing of the main prompt (compiled_prompt)
  • EXTRA: enable/disable processing of the extra block (extra_compiled)
• Outputs:
  • compiled_prompt (STRING): the processed main prompt (empty when PROMPT is off)
  • extra_compiled (STRING): the processed extra block (empty when absent or EXTRA is off)

4. Text is empty [darkilNodes]

• Category: darkilNodes/text
• Description: Checks if a text string is empty or contains only whitespace.
• Inputs:
  • text (STRING): The text to check
• Outputs:
  • BOOLEAN: True if the text is empty, False otherwise

5. Text not empty [darkilNodes]

• Category: darkilNodes/text
• Description: Checks if a text string contains content.
• Inputs:
  • text (STRING): The text to check
• Outputs:
  • BOOLEAN: True if the text is not empty, False otherwise

6. Text lines count [darkilNodes]

• Category: darkilNodes/text
• Description: Counts the number of lines in a text string.
• Inputs:
  • text (STRING): The text to count lines for
• Outputs:
  • INT: Number of lines in the text

7. Strings Joiner [darkilNodes]

• Category: darkilNodes/text
• Description: Joins multiple text inputs with a specified separator.
• Features:
  • Supports dynamic number of text inputs via DYNAMIC_* slots
  • Escape sequence support (\n for newline, \t for tab)
  • Filters empty/None values before joining
• Inputs:
  • joiner: Separator string used to join texts (supports escape sequences)
  • DYNAMIC_*: Dynamic text inputs to join
• Outputs:
  • joined_text: Combined text with joiner as separator

Logic Nodes

1. Multi toggles [darkilNodes]

• Category: darkilNodes/logic
• Description: Provides multiple toggle switches for selecting options.
• Features:
  • Configurable via node properties
  • Supports radio button behavior
  • Customizable delimiter and last word for string joining
• UI Configuration Properties:
  • text_for_toggles: Defines toggle options (semicolon or pipe separated)
  • is_radio_toggles: Enables radio button behavior
  • trim_values: Trims whitespace from values
  • last_word: Custom word before final item in joined string
  • delimiter: String used to join items

2. Custom combo box [darkilNodes]

• Category: darkilNodes/logic
• Description: Allows selection from a custom combo list.
• Features:
  • Configurable via node properties
  • Supports semicolon or pipe separated items
  • Outputs selected value and help text
• UI Configuration Properties:
  • text_for_combo: List of items (semicolon or pipe separated)

3. Diffusion Model Load Later [darkilNodes]

• Category: darkilNodes/logic
• Description: Loads the diffusion model into memory later in the workflow chain.
• Features:
  • Allows connecting the loader of the model along the chain
  • Allows clearing the model cache
  • Allows unloading models from memory
• Inputs:
  • any_trigger: Any type as a trigger for loading the diffusion model
  • unet_name: Name of the diffusion model to load
  • weight_dtype: Weight data type (default, fp8_e4m3fn, fp8_e4m3fn_fast, fp8_e5m2)
  • empty_cache: Clears the ComfyUI cache if enabled
  • gc_collect: Python gc.collect()
  • unload_models: Unloads previously loaded models from memory

4. CLIP Load Later [darkilNodes]

• Category: darkilNodes/logic
• Description: Loads the CLIP model into memory later in the workflow chain.
• Features:
  • Allows connecting the CLIP loader along the execution chain
  • Supports memory cleanup options
• Inputs:
  • any_trigger: Any type as a trigger for loading the CLIP model
  • Standard CLIP loader inputs (clip_name, type)
  • empty_cache: Clears the ComfyUI cache if enabled
  • gc_collect: Python gc.collect()
  • unload_models: Unloads previously loaded models from memory

5. DualCLIP Load Later [darkilNodes]

• Category: darkilNodes/logic
• Description: Loads the DualCLIP model into memory later in the workflow chain.
• Features:
  • Allows connecting the DualCLIP loader along the execution chain
  • Supports memory cleanup options
• Inputs:
  • any_trigger: Any type as a trigger for loading the DualCLIP model
  • Standard DualCLIP loader inputs (clip_name1, clip_name2, type)
  • empty_cache: Clears the ComfyUI cache if enabled
  • gc_collect: Python gc.collect()
  • unload_models: Unloads previously loaded models from memory

6. VAE Load Later [darkilNodes]

• Category: darkilNodes/logic
• Description: Loads the VAE model into memory later in the workflow chain.
• Features:
  • Allows connecting the VAE loader along the execution chain
  • Supports memory cleanup options
• Inputs:
  • any_trigger: Any type as a trigger for loading the VAE model
  • Standard VAE loader input (vae_name)
  • empty_cache: Clears the ComfyUI cache if enabled
  • gc_collect: Python gc.collect()
  • unload_models: Unloads previously loaded models from memory

7. Multi Set [darkilNodes]

• Category: darkilNodes/logic
• Description: Creates a named group that dynamically generates matching input and output slots.
• Features:
  • Define a group name via widget; the name is kept unique across the graph.
  • When an input slot is connected, the node automatically creates a corresponding output slot with matching type and a generated name (<type>_<index>).
  • Supports a wildcard placeholder pair that is always kept free for further connections; extra placeholders are removed automatically.
  • Works with both native Multi Set nodes and KJNodes SetNode (compatibility mode).
  • Propagates color changes to linked Get nodes.
  • Virtual node – does not affect prompt serialization.

8. Multi Get [darkilNodes]

• Category: darkilNodes/logic
• Description: Reads a group created by a Multi Set node and generates matching output slots dynamically.
• Features:
  • Group selector combo box populated with all existing Multi Set groups in the current graph.
  • Automatically rebuilds its outputs to mirror the inputs of the associated Multi Set node (type, order, naming).
  • Preserves existing connections when the group changes or when slots are added/removed.
  • Validates links to avoid type mismatches.
  • Synchronizes node colour with its corresponding Multi Set node.

9. Multi Get AIO [darkilNodes]

• Category: darkilNodes/logic
• Description: An "All-In-One" version of Multi Get that can pull data from multiple groups at once.
• Features:
  • Widget to set the number of groups (1–100) and a combo box for each group to select an existing Multi Set group.
  • Generates output slots for every input of every selected group, naming them as <type>_<index> [ <group_index> ].
  • Maintains connections across re-configuration by mapping old outputs to new ones based on group name and original input index.
  • Supports colour inheritance from each source Multi Set node.
  • Validates and cleans up broken links automatically.
  • Virtual node – does not affect prompt serialization.

Multi Set / Multi Get / Multi Get AIO (web/js/multi_set_get.js) are derived from ComfyUI-KJNodes (© kijai and contributors) and, unlike the rest of this MIT-licensed package, are licensed under GPL-3.0. See web/js/LICENSE.GPL-3.0.txt.

10. Constant setter [darkilNodes]

• Category: darkilNodes/logic
• Description: Sets a constant value of various types for use in workflows.
• Features:
  • Supports multiple data types: STRING, INT, FLOAT, BOOLEAN, COMBO
  • Slider/Knob controls with configurable min/max ranges
  • Type conversion from input values
  • Virtual node – does not affect prompt serialization
• UI Configuration Properties:
  • const_type: Data type (STRING, INT, FLOAT (FLOAT2-FLOAT5), BOOLEAN, COMBO, SLIDER (SLIDER2-SLIDER5), KNOB (KNOB2-KNOB5))
  • default_value: Default constant value
  • minimum, maximum: Range bounds for numeric types
  • values: Semicolon-separated list for COMBO type
  • input_enable: Enable input slot for value conversion

11. Any Switch [darkilNodes]

• Category: darkilNodes/logic
• Description: Passes through the first input that is both connected and enabled. Tolerant like rgthree's Any Switch — it never errors when nothing is connected.
• Features:
  • Dynamic any_* inputs — a new slot appears once the last one is filled; extra empty slots are trimmed automatically.
  • A per-input checkbox in the right column: uncheck it to skip that input without disconnecting the upstream node.
  • Inputs are scanned top to bottom; the first enabled + connected one is returned. Falsy-but-valid values (0, empty string) still pass through.
  • If nothing qualifies, the node outputs None instead of raising.
  • Any-type input and output (*) — accepts and forwards any data type.
• Inputs:
  • any_1, any_2, … (ANY): the values to switch between (added dynamically)
• Outputs:
  • value (ANY): the first enabled + connected input (or None)

12. Show Any [darkilNodes]

• Category: darkilNodes/logic
• Description: A universal preview node that renders whatever is connected, chosen by the value's runtime type, and passes the value through unchanged on value.
• Features — renders by detected type:
  • Text / number — selectable, copyable text.
  • JSON (a dict, or a string that parses as JSON) — a collapsible tree with a Tree / Raw toggle.
  • Boolean — a large green check / red cross.
  • Number list ([1, 2, 3], or a numeric-array string) — a read-only equalizer chart with value labels and auto-range.
  • Matrix / list of lists ([[...], [...]]) — stacked mini-equalizers, 10 per page with prev/next pagination.
  • Image(s) / mask — inline image preview(s); masks are shown as grayscale.
  • Video — an HTML <video> player.
  • Audio — an HTML <audio> player.
  • Markdown — rendered markdown (choose Markdown in the view combo).
  • Text / JSON / markdown / image / video panels fill the node as it is resized.
  • History - the last 20 values are kept per node, whatever their type.
  • The value survives a redraw. Coming back to the browser tab, switching workflows, or anything else that makes the frontend rebuild the graph no longer blanks the node: the history is held outside the node, and the last value is written into the node itself, so it comes back after a page reload too. A value restored that way is labeled restored until the node runs again.
  • A new value never steals the view while an older one is on screen: the counter turns orange and >| goes back to the newest.
  • Nothing has to leave with the workflow. x in the bar forgets the saved copy along with the older entries, and the right-click menu has forget the value saved in the workflow, forget it on every Show Any node for the whole graph at once, and stop keeping the value in the workflow, after which the node saves nothing at all and its bar says not saved. That last one is the node property showany_keep, so the properties panel flips it too. The value on screen is left alone by all of them - that copy goes nowhere.
• UI:
  • History bar above the panel: < > step one value, >| jumps to the newest, x forgets everything except the value on screen, the copy stored in the workflow included. The middle of the bar shows the position and the time of the run.
  • view (COMBO, shown for strings): Auto / Text / Markdown / JSON. Auto shows a JSON tree, or an equalizer for numeric arrays, otherwise plain text.
• Inputs:
  • source (ANY, optional): the value to display
• Outputs:
  • value (ANY): the input passed through unchanged

WAN Nodes

1. I2V Encode with Middle Frame [darkilNodes]

• Category: darkilNodes/wan
• Description: Clone of WanVideoWrapper's 'WanVideo ImageToVideo Encode' with added middle frame support. Built from code of other custom node projects.
• Features:
  • Accepts start_image, middle_image (optional), and end_image (optional)
  • middle_frame_ratio controls the position of the middle frame (0.0 = start, 1.0 = end)
  • middle_latent_strength controls the conditioning strength of the middle frame in latent space
  • motion_amplitude (>1.0) enhances inter-frame motion
  • Supports noise augmentation, tiled VAE encoding, and empty frame padding
• Based on:
  • ComfyUI-Wan22FMLF
  • ComfyUI-PainterI2VforKJ
  • ComfyUI-WanVideoWrapper
• Inputs:
  • width, height, num_frames
  • noise_aug_strength, start_latent_strength, end_latent_strength, middle_latent_strength
  • middle_frame_ratio, motion_amplitude, force_offload
  • vae (WANVAE)
  • start_image, middle_image, end_image
  • clip_embeds, control_embeds, temporal_mask, extra_latents
  • tiled_vae, fun_or_fl2v_model, augment_empty_frames, empty_frame_pad_image
• Outputs:
  • image_embeds (WANVIDIMAGE_EMBEDS)

2. LoRA list for WanVideoWrapper by Kijai [darkilNodes]

• Category: darkilNodes/wan
• Description: Parses textual lists of LoRA definitions for WanVideoWrapper nodes by Kijai.
• Features:
  • Supports multiple input formats (newlines, semicolons, pipes)
  • Handles comments (both line and block style)
  • Low/high noise model targeting with prefixes
  • Block selection support
  • Merging of LoRAs for efficiency
  • Previous list merging capability
• Input Format:
  • <LoRA name>[:<strength>]
  • Prefixes: l<<, l<, <low:, low: for low-noise model, h<<, h<, <high:, high: for high-noise model
• Special Features:
  • Supports block comments /* ... */ and line comments // ...
  • Optional merging of multiple LoRAs into a single tensor
  • Low-memory loading option
  • Automatic handling of missing files with error logging

MiniMax H3 Nodes

1. MiniMax H3 Multi Keyframe [darkilNodes]

• Category: darkilNodes/minimax
• Description: Replacement for the core 'MiniMax H3 Image to Video' node that anchors keyframes anywhere on the timeline instead of only at the first and the last frame. Returns the conditioning and the AV latent as the core node does, plus the model that carries the layout patch.
• Requires: a ComfyUI build with MiniMax H3 support (comfy_extras/nodes_minimax_h3.py, comfy/ldm/minimax/model.py).
• Features:
  • middle_frames takes a batch of images, one anchor per image
  • middle_positions holds one value per image, written as a 0.0-1.0 ratio or as an absolute frame index, or left empty to spread the anchors evenly
  • anchors are clamped to the interior of the clip, and the length is snapped up to the model's 17k+5 frame grid first
  • anchors reach the text encoder as <Picture N> in temporal order, so the first picture is the earliest frame
  • keyframe_noise_aug sets the condition strength of every anchor; 0.999 is the core value, lower blends noise into the anchors
  • the first and the last anchor are laid out exactly where the core node puts them
• How it works: the core path already carries a list of keyframes of any length - one condition segment per entry, one condition latent per entry - and only PackedLayout refuses an anchor other than frame 0 and the last frame. The temporal RoPE coordinate of a condition row is linear in the pixel frame index (origin + 5/3 * index, the 40 Hz RoPE over 24 fps video), and that single expression reproduces both core anchors exactly. The node builds the keyframe list with real indices and returns a model carrying an OUTER_SAMPLE wrapper, which installs a marker-gated PackedLayout patch for the duration of one sampling run and removes it in a finally block. Nothing is patched process wide, and keyframes without the marker - including those from other packs - are handed to the core code untouched.
• Wiring: clip, vae and model come from the same places as for the core node, and the model output has to reach the sampler (the guider). Without it the run stops with the core error only first/last keyframe anchors are supported rather than quietly stacking every anchor on frame 0.
• Inputs:
  • model (MODEL), clip (CLIP), vae (VAE)
  • prompt, width, height, length
  • middle_positions, position_units (ratio / frames), middle_fit (cover / stretch), keyframe_noise_aug
  • first_frame, last_frame, middle_frames (IMAGE, all optional)
• Outputs:
  • positive (CONDITIONING), latent (LATENT), model (MODEL)
• Notes:
  • H3 was trained with first and last anchors (fl2va), so a middle anchor is outside that distribution. It does hold in practice - a marker drawn on the middle image shows up in the middle of the clip, with the motion around it staying consistent - but the further past three anchors it goes, the less trodden the ground.
  • Each extra anchor adds one condition segment to the packed sequence, about 1000 rows at 1344x768.
  • keyframe_noise_aug below 0.999 is the first knob to reach for when the model fights an anchor.

Conditioning Nodes

1. Krea2 Rebalance Equalizer [darkilNodes]

• Category: darkilNodes/conditioning
• Description: Per-layer conditioning scaler for the Krea 2 (Qwen3-VL-4B, 12-layer tap) layout. Adjust the gain of each model tap layer with a built-in equalizer, then scale the whole conditioning by a multiplier.
• Features:
  • Horizontal equalizer with 12 vertical faders, one per Krea 2 tap layer (labeled 2, 5, 8, … 35), range −2.0 … 10.0
  • multiplier rendered as a matching horizontal slider (−10.0 … 10.0)
  • "Reset to defaults" button
  • Presets: save the current profile (multiplier + 12 weights) under a name, load it from a combo box, delete with the red ✖. Presets are stored server-side in nodes/conditioning/krea2_eq_presets.json (shared across browsers/workflows on the machine; no extra port — served by the existing ComfyUI server)
  • Fully custom-drawn UI with no external JS dependencies
• Inputs:
  • conditioning (CONDITIONING): the conditioning to rescale
  • multiplier (FLOAT): global scale applied to the whole conditioning
• Outputs:
  • conditioning (CONDITIONING): the rescaled conditioning
• Based on:
  • ComfyUI-Conditioning-Rebalance (Apache-2.0) — vendored scaling helpers, see nodes/conditioning/THIRD_PARTY_LICENSES.txt

File Handling Nodes

1. Files list from dir [darkilNodes]

• Category: darkilNodes/files
• Description: Lists files in a directory based on extension and sorting criteria.
• Features:
  • Supports glob patterns for file filtering
  • Multiple sorting options (by date, name, size)
  • Recursive subdirectory search capability
  • Configurable output format (with/without extensions, full paths)
• Inputs:
  • folder_path (STRING): Path to the directory to scan
  • files_extension (STRING): Extension filter; can be a simple extension (e.g., "png") or any glob pattern (e.g., "*.txt")
  • sort_by (COMBO): Sorting method – by date, name, size and their descending variants
  • sub_foldres (BOOLEAN): If true, search recursively in sub-folders
  • keep_extensions (BOOLEAN): Keep file extensions in the output names
  • keep_full_path (BOOLEAN): Return full absolute paths instead of just filenames
• Outputs:
  • found_list (STRING): List of file names/paths
  • found_as_text (STRING): Newline-separated string of all files
  • last_filename (STRING): Name/path of the last file after sorting
  • first_filename (STRING): Name/path of the first file after sorting
  • files_count (INT): Total number of files found

Installation

1. Clone or download this repository into your ComfyUI custom_nodes folder:

   cd ComfyUI/custom_nodes
   git clone https://github.com/pytraveler/comfyui-darkil-nodes.git
   

2. Restart ComfyUI to load the new nodes.

Usage Examples

LoRA Management Example

Wan22VideoLoraListBuilder → WanVideoSetLoRAs (Kijai)

License

MIT License for the package as a whole — see the LICENSE file for details.

Component exceptions (derivative works under their upstream licenses):

• web/js/multi_set_get.js (Multi Set / Multi Get / Multi Get AIO) is licensed under GPL-3.0, derived from ComfyUI-KJNodes (© kijai and contributors). Full text: web/js/LICENSE.GPL-3.0.txt.
• nodes/conditioning/rebalance_core.py — Apache-2.0, see nodes/conditioning/THIRD_PARTY_LICENSES.txt.
• nodes/wan/i2v_encode_middle.py — adapts Apache-2.0 code from WanVideoWrapper and related projects (see the node's "Based on" list above).

See the "Component licenses" section of the LICENSE file for the full list.