Add Folder

Add Folder is the second-cheapest node in ComfyUI_Eclipse, right after Add Filename Prefix, and it's the one you reach for when your outputs are a flat pile of PNGs. It joins a folder name onto a base path and hands you back a string. That's the whole job - and it's genuinely useful, because organizing output is the one chore almost no workflow bothers to automate.

The mechanism is a single os.path.join. You feed it a path (the base, like D:\ComfyUI\output) and a folder_name (default "SubFolder"), and it returns D:\ComfyUI\output\SubFolder. If the base path is empty it returns an empty string; if the folder name is empty it returns the path unchanged. No magic, no filesystem side effects - it builds the string, and whatever consumes it (a Save Images node, Smart Folder, your video save node) does the directory creation.

The inputs and output that matter

• path - the base path. It's force_input, so you can type it or wire it from another node. Best practice is to wire it from a single source (Eclipse's Folder Path node) so you change the project root in one place.
• folder_name - what gets appended. Defaults to SubFolder.
• Output: one string, ready to feed into any path input.

The real power is chaining. Want per-batch folders? Add Folder on output with batch_42, then a second Add Folder on that with the character name. You build the hierarchy once with string nodes and every save node downstream inherits it. That's the pattern the plumbing layer exists for - one authoritative value fanned out to five consumers, instead of five paths you have to remember to update together.

Installing it

Part of the ComfyUI_Eclipse pack, installed once:

cd ComfyUI/custom_nodes
git clone https://github.com/r-vage/ComfyUI_Eclipse

Then restart ComfyUI, or use ComfyUI Manager and search "ComfyUI Eclipse". It needs nothing beyond the Python standard library, so there are no extra dependencies to worry about for this one.

Gotchas

Two things to keep straight. First, the string it returns is a logical path - if the folder doesn't exist yet, that's fine, but only a downstream node that resolves paths will actually create it. Don't expect this node to touch the disk. Second, the pack-wide migration gotcha: ComfyUI_Eclipse was formerly RvTools, and v4.0.0 removed all legacy nodes. Old workflows using the Eclipse folder nodes should be run through the Workflow Migration Tool node (or python tools/migrate_workflow.py <workflow.json> from the repo) which rewrites the old IDs and backs up the original file.

One more honest note: this is a utility, not a feature. If your workflow saves into a single folder and you like it that way, you don't need it. You'll reach for it the first time you run fifty variations of the same prompt and can't tell the outputs apart.