Folder Path

A week of generating images leaves you with one giant output/ folder and no way to tell which batch was which. Folder Path is the small node that fixes the "where did this go" problem before it starts: it builds a dated, batch-numbered output path - output/images/2026-08-25/batch_3/ - and hands it to your save nodes as a string. No manual folder creation, no renaming later.

What it is

A path builder in the Eclipse Folder family (alongside Add Folder, Filename Prefix, and the heavyweight Smart Folder). It composes a folder path under ComfyUI's output directory from three optional parts: a root folder name, a date/time subfolder, and a batch subfolder. The output is a single string you can feed into any save/loader node that accepts a path.

How it works

The logic is straightforward composition. You give it a root_folder (default "images"), it optionally appends a date/time folder formatted with strftime syntax (date_time_format, default %Y-%m-%d), and optionally appends a batch folder using a {} placeholder for the number (batch_folder_name, default "batch_{}"). The date folder can be a prefix or postfix relative to the root (date_time_position), and if the format string is invalid it silently falls back to %Y-%m-%d rather than crashing.

The batch handling is where it earns its keep. batch_number_control has two modes:

• fixed - keeps whatever batch_number you set (default 1).
• increment - auto-increments the batch number after each queue, so every run lands in a fresh folder automatically.

That increment mode is the "hands-off organization" feature: queue a run, get a new folder, never collide with the last run's output.

Inputs that matter

• root_folder - top-level folder under ComfyUI/output.
• create_date_time_folder / date_time_format - the date stamp; tweak the format for %Y-%m-%d_%H-%M if you want run-level precision.
• create_batch_folder / batch_folder_name / batch_number / batch_number_control - the batch layer, including the auto-increment switch.

Output

One output: path (STRING) - the full folder path, ready to wire into Save Images / Save Video path inputs or a Smart Folder chain.

Install

Part of ComfyUI_Eclipse (formerly RvTools, rewritten in v4.0.0). Manager → ComfyUI_Eclipse → install → restart, or:

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

Under Eclipse → Folder. No models or extra deps.

Troubleshooting

• Folder never changes between runs: batch_number_control is set to fixed - switch to increment, or drive batch_number from an Integer (Gen) node for explicit control.
• Date is wrong: date_time_format uses strftime tokens - %Y is year, %m month, %d day, %H/%M hours/minutes. A bad token silently falls back to %Y-%m-%d.
• Path doesn't exist: this node only builds the path string; creating the folder is the save node's job. If nothing saves there, check that your save node creates directories or that the folder is reachable.