ComfyUI Node

ListPath

Turn one path string into a list of paths

By ruiqutech·Created 2 years ago·Updated 2 years ago· 0
ListPath
    • path
    • show_help
    path
    prefix
    suffix
    delimiter,
    count0

    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) and show_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.

    Categoryruiqu/path

    Inputs (5)

    NameTypeDefaultDescription
    pathSTRING
    prefixoptSTRING
    suffixoptSTRING
    delimiteroptSTRING,
    countoptINT00–9999

    Outputs (2)

    NameTypeDescription
    pathSTRING
    show_helpSTRING