Smart Folder

If you generate more than a handful of images, you've had the moment where your output folder is a flat graveyard of ComfyUI_00001.png files and you can't find Tuesday's batch. Smart Folder is Eclipse's answer: one settings node that defines a structured output path - root folder, date/time subfolder, optional batch subfolder - and hands the whole configuration to downstream nodes as a single pipe. Set it once, and every save in the workflow follows the same folder discipline.

It's also the node where the pack's pipe ecosystem starts being useful instead of abstract. Smart Folder packs a surprisingly large amount of generation configuration into that one pipe output - folder structure, image or video resolution, latent type, video frame parameters, even an optional seed - so downstream Eclipse nodes (Save Images, Pipe Out Smart Folder, the various context and loader nodes) can read what they need without a dozen separate wires. That's the pipe philosophy in the README: bundle related parameters into one object instead of connecting ten wires.

How it works

The path builds up in layers:

<ComfyUI output dir> / <root_folder> / [date_time] / [batch_folder]

The inputs that matter, keeping it to the ones you'll actually touch:

• generation_mode - Image Mode or Video Mode. The node shows different settings per mode, so don't hunt for video controls in image mode.
• root_folder_image / root_folder_video - the base folder name for each mode (defaults images / videos).
• create_date_time_folder (on) and date_time_format (%Y-%m-%d by default) - the strftime-based subfolder. Postfix appends the date to the folder name, prefix prepends it.
• create_batch_folder (off) - adds a batch subfolder using batch_folder_name (supports formatting like batch_{}), with batch_number_control choosing fixed or increment-after-each-queue.
• use_image_size (off) - enables the image resolution block (preset dropdown, width/height, latent_type). The tooltip says it straight: disable this when using Smart Loader for latent size, so you don't fight two sources of truth.
• use_seed and seed - include a seed in the pipe, with -1 random, -2 increment, -3 decrement for folder naming.

The pipe output carries all of it downstream.

Where it fits

Any workflow that saves output - which is to say, every workflow. It shines in two cases: long-running batch jobs where a date-and-batch folder structure keeps runs separable, and template workflows you share, where the folder discipline rides along with the graph. Pair it with the pack's Save Images node, which knows how to consume the pipe and build filenames from it.

Installing it

Part of ComfyUI_Eclipse:

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

Or ComfyUI Manager → search "ComfyUI_Eclipse" → install and restart. No models. It uses standard ComfyUI output paths, so nothing extra to configure.

Gotchas

The main trap is the two sources of truth: if you enable use_image_size and let a Smart Loader set latent size, they can disagree - the tooltip's advice to disable image size when Smart Loader is in the loop is there because people hit exactly that. And remember the video parameters (context length, loop count, overlap) only show in Video Mode; users hunting for them in Image Mode assume the node is broken when it isn't. Old RvTools-era workflows predating v4.0.0 need the migration tool; fresh ones load clean.