Folder Version Incrementer

Folder Version Incrementer exists because the author got annoyed with folder methods. Likhith-24 (who publishes this pack as Code2Collapse on GitHub, and posts on r/comfyui) said as much in his launch post: he had "annoying feelings about folder methods," so he built this node. The problem it solves is the one every ComfyUI user hits after their tenth save: output.png, output (1).png, output (2).png - no order, no grouping, no way to know which pass is the latest.

This node scans your output directory and hands you the next free version number as real folder structure: output/<shotname>/<MM-DD-YYYY>/v001/<shotname>.png, then v002, v003… Each day starts fresh at v001, so a week of sessions doesn't produce a single flat folder of 300 files. It's one of the three FolderIncrementer nodes in ComfyUI-CustomNodePacks, and it's the workhorse of the trio.

How it works

The design philosophy is in the details:

• Filesystem-based, not counter-file-based. It scans the actual directory for v001, v002, … and returns the next one that doesn't exist. No JSON counter that drifts out of sync when you delete files or move folders - the truth lives on disk.
• Cancel-safe. The version folder is claimed when the node actually runs. If you cancel a queue mid-way and that node never executes, no version number is wasted.
• It derives its folder name from your source file. Connect trigger_image / trigger_video (or a source_path / source_filename), and SC_30_SHT50.mp4 becomes output/SC_30_SHT50/<date>/v001/SC_30_SHT50.mp4. The pack's JS companion auto-fills the source name from whatever loader you connect.
• Optional suffix for pass tagging. Want to tag a pass without cluttering the folder? suffix with suffix_mode=filename appends to the basename (clip_mask.mov); subfolder nests v001/mask/; folder creates a separate top-level folder with its own versioning. No more downstream Concatenate nodes just to tag a run.

The outputs that matter

The node spits out a lot of strings - here's what you actually wire:

• version_string (v001) and version_number (1) - the version itself.
• subfolder_path (shot/v001) - wire this into Save Image's subfolder input, or fold it into a filename prefix, and your saves land in the right place automatically.
• filename_prefix and output_filename - ready-to-use paths for Save Image / VHS-style save nodes.
• folder_name - the sanitized shot name, if you need it separately.

Wire version_string into your Save Image filename_prefix and every queued prompt produces a clean ordered file series. That's the whole loop.

Installing it

Ships in ComfyUI-CustomNodePacks. ComfyUI Manager → search "CustomNodePacks", or:

cd ComfyUI/custom_nodes
git clone https://github.com/Code2Collapse/ComfyUI-CustomNodePacks.git

Needs nothing beyond stdlib file operations, so it works the moment the pack loads. The pack overall wants opencv-python>=4.7.0 and scipy>=1.10.0 for other nodes - add just those if missing (skip the full requirements.txt; it can clobber ComfyUI's torch). Restart ComfyUI.

Common issues

• Versions aren't incrementing - check date_format. Versions are scoped per day; if you changed the format string, the date folder changes and scanning restarts at v001.
• The folder name is "default" - nothing is connected upstream, so the node fell back to the label widget. Connect a loader or set source_choice / custom_name.
• Output landed somewhere unexpected - base_path overrides the output root; leave it empty for ComfyUI's normal output dir.
• You want to control the version, not just advance it - that's the job of the pack's Folder Version Set (reserve slots) and Folder Version Check (report the current state).

The honest take: it's the rare utility node that changes your habit. Once your saves are versioned folders instead of (1), (2), (3), you'll wonder how you ever QA'd a sweep without it.