# Custom ComfyUI Nodes Languages: **English** · [Русский](README_RU.MD) This repository contains custom nodes for ComfyUI that extend functionality for workflows. ## Available Nodes ### Text Processing Nodes #### 1. Variable builder [darkilNodes] ![Variable builder](docs/images/node_var_build.png) - **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] ![Advanced variable builder](docs/images/node_adv_var_build.png) - **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] ![Dynamic prompt builder 1](docs/images/node_prompt_build_1.png) ![Dynamic prompt builder 2](docs/images/node_prompt_build_2.png) - **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] ![Text is empty](docs/images/node_text_is_empty.png) - **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] ![Text not empty](docs/images/node_text_not_empty.png) - **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] ![Text lines count](docs/images/node_lines_count.png) - **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] ![Strings Joiner](docs/images/node_str_joiner.png) - **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] ![Multi toggles 1](docs/images/node_multi_toggle_1.png) ![Multi toggles 2](docs/images/node_multi_toggle_2.png) - **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] ![Custom combo box 1](docs/images/node_combo_1.png) ![Custom combo box 2](docs/images/node_combo_2.png) - **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] ![Diffusion model loader later](docs/images/node_diff_model_later.png) - **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] ![Multi Set](docs/images/node_setget.png) - **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 (`_`). - 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 `_ [ ]`. - 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](https://github.com/kijai/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] ![Constant setter 1](docs/images/node_constant_setter_1.png) ![Constant setter 2](docs/images/node_constant_setter_2.png) ![Constant setter 3](docs/images/node_constant_setter_3.png) - **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 ### WAN Nodes #### 1. I2V Encode with Middle Frame [darkilNodes] ![I2V Encode with Middle Frame](docs/images/node_wanvideowrapper_i2v_.png) - **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](https://github.com/wallen0322/ComfyUI-Wan22FMLF) - [ComfyUI-PainterI2VforKJ](https://github.com/princepainter/ComfyUI-PainterI2VforKJ) - [ComfyUI-WanVideoWrapper](https://github.com/kijai/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] ![LoRA list for WanVideoWrapper by Kijai](docs/images/node_wan22.png) - **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**: - `[:]` - Prefixes: `l<<`, `l<`, `

Name	Type	Description
str_selected	STRING	—
❓help	STRING	—

Custom combo box [darkilNodes]

Inputs (1)

Outputs (2)