comfyui-misc

ComfyUI custom nodes focused on small utility workflows.

Nodes

1) Any Switch (misc)

Selects one value from dynamic any_01, any_02, ... inputs.

• Input
  • select_index (INT):
    • -1: automatically choose the first non-empty any_* input
    • 0 or higher: force selection of any_{index+1}
  • any_01, any_02, ... (*): dynamic optional inputs
• Output
  • *: selected value
  • index (INT): selected input index (0-based)

How to use

1. Connect multiple candidates to any_* inputs.
2. Keep select_index=-1 for auto mode, or set a number for fixed mode.
3. Use index when downstream nodes need to know which branch was chosen.

---

2) Any Output Switch (misc)

Routes one input to one of dynamic outputs any_01, any_02, ...

• Input
  • input (*): value to route
  • select_index (INT):
    • -1: route to the first connected output slot
    • 0 or higher: force route to any_{index+1}
• Output
  • any_01, any_02, ... (*): dynamic outputs (only one is active)
  • index (INT): selected output index (0-based)

How to use

1. Connect input from an upstream node.
2. Connect each destination node to desired any_* outputs.
3. Choose auto mode (-1) or fixed mode (>=0) with select_index.

---

3) Any Split (misc)

Splits one LIST or BATCH input into dynamic outputs any_01, any_02, ...

• Input
  • * (*): list or batched value (no type check)
  • Send to CPU (BOOLEAN, default false): when enabled, moves each split output to CPU via .to("cpu")
• Output
  • any_01, any_02, ... (*): one element per slot; output type follows upstream
  • length (INT): number of elements after split

How to use

1. Connect a LIST output (e.g. from a list node) or a BATCH value (e.g. batched IMAGE / MASK) to *.
2. Wire each downstream consumer to any_* outputs.
3. Use length when the element count is needed downstream.

Notes

• LIST inputs are flattened; BATCH tensors are split along the leading batch dimension.
• MASK batches in [B, 1, H, W] layout are normalized to [B, H, W] before split.

---

4) Combine Primitives (misc)

Combines primitive values into a single combined package.

• Supported primitive types
  • INT, FLOAT, STRING, BOOLEAN, COMBO
• Input
  • primitive_01, primitive_02, ... (PRIMITIVE) dynamic optional inputs
• Output
  • combined (PRIMITIVES)
  • length (INT): number of packed primitive values

How to use

1. Connect primitive-producing nodes to primitive_* inputs.
2. Send combined to Split Primitives (misc) or another compatible node.
3. Use length for loops/validation.

---

5) Split Primitives (misc)

Unpacks combined produced by Combine Primitives (misc).

• Input
  • combined (PRIMITIVES)
• Output
  • INT_01, FLOAT_02, ... (PRIMITIVE) dynamic outputs (typed names)
  • length (INT)

How to use

1. Connect combined from Combine Primitives (misc) (creating Split from the combined output search also syncs correctly).
2. Connect downstream primitive consumers to typed outputs such as INT_01.
3. Output slots auto-sync with upstream combine connections (even through relay nodes such as Any Switch (misc) and Reroute).
4. On workflow load / copy-paste restore, output links are preserved first and type-specific sync is applied after graph restoration settles.

---

6) ForEach (misc)

Unpacks combined and runs downstream nodes once per primitive value (ComfyUI list execution).

• Input
  • combined (PRIMITIVES)
• Output
  • *: current element; label/type stay * even when connected (no type check)

How to use

1. Connect combined from Combine Primitives (misc).
2. Wire the * output through processing nodes to End ForEach (misc).

---

7) End ForEach (misc)

Collects per-iteration results from the loop body into combined again.

• Input
  • value (*): label/type stay * even when connected (no type check); usually wired from the last node in the loop body
• Output
  • combined (PRIMITIVES)

How to use

1. Connect the loop body output to value.
2. Connect combined to Split Primitives (misc) (output names such as STRING_01, STRING_02, … sync from the original Combine).

Installation

1. From ComfyUI/custom_nodes:

   git clone https://github.com/wraith-executioner-year-2/comfyui-misc/

2. Restart ComfyUI.

3. Node category: misc.

Notes

• Dynamic slots are synchronized in web/ (attachStabilizeHooks / stabilize).
• After load or copy-paste, slot removal is suppressed until links restore, then stabilize() trims unused sockets.
• See CHANGELOG.md for version history.

Development

npm install
npm test        # unit tests (no ComfyUI)
npm run format  # Prettier (JS only, no trailing commas)

• Tests: test/web/ mirrors web/ layout (e.g. test/web/utils/graph_context.test.js)
• Copy-paste restore: test/web/logic/paste_restore.test.js