ListPath
Turn one path string into a list of paths
- path
- show_help
A plumbing node: it takes a single path-shaped string and turns it into a list of path strings ComfyUI can iterate over. The everyday need behind it is feeding a batch loader or a loop with a set of file locations built from a pattern, instead of hand-typing each path separately or wiring a pile of individual string nodes together.
Inputs and outputs
path(STRING, required) - your starting string.prefix,suffix(STRING, optional) - text to add around the pieces of the result.delimiter(STRING, optional, default,) - what separates entries.count(INT, optional, 0–9999) - a count that either caps or drives how many entries you get.- Outputs:
path(STRING,is_list: true- the resulting list) andshow_help(STRING - a self-documentation string).
What the fields tell you
The field names spell out the shape even without a written spec for the exact splitting rule: delimiter defaulting to a comma strongly implies path gets split into multiple entries wherever that character shows up, with prefix and suffix wrapped around each resulting piece. count reads as either a cap on how many entries you get back, or - combined with prefix/suffix - a way to generate a numbered sequence of paths rather than split an existing string at all (a common pattern for things like frame_001, frame_002, … up to count).
That's an honest limit of what's documented here: there's no README detail on the exact rule, and this node's own source isn't part of what's available to write this article from. Which is exactly what show_help is for.
Use the node's own help output
Wire show_help into a Show Text node (or anything that displays a string) the first time you drop ListPath into a graph. It's self-documentation built into the node - faster and more reliable than guessing the exact syntax from field names alone, and it'll tell you precisely how delimiter, prefix, suffix, and count interact for whatever version of the pack you actually have installed.
Installing it
ComfyUI Manager: search RuiquNodes, install, restart. Manual:
cd ComfyUI/custom_nodes
git clone https://github.com/ruiqutech/ComfyUI-RuiquNodes
then restart. No models or extra dependencies to fetch.
Common issues
The output list isn't what you expected. Check show_help first - since the exact split/generate behavior isn't spelled out anywhere outside the node itself, it's the fastest way to confirm what delimiter and count are actually doing before you assume something's broken.
Downstream node only processes one item instead of the whole list. Confirm the receiving node is actually set up to iterate a list input - ComfyUI only fans out execution over a list when the node on the other end expects one; otherwise you may just be getting the first entry.
prefix/suffix not showing up in the result. They're optional inputs with empty-string defaults - if you left them unwired or blank, there's nothing to add, which is expected, not a bug.
Inputs (5)
| Name | Type | Default | Description |
|---|---|---|---|
| path | STRING | — | |
| prefixopt | STRING | — | |
| suffixopt | STRING | — | |
| delimiteropt | STRING | , | — |
| countopt | INT | 00–9999 | — |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| path | STRING | — |
| show_help | STRING | — |