ComfyUI Node: Folder Version Set

Folder Version Set:

The FolderIncrementerSet node is designed to manage and reserve version slots by creating empty placeholder directories within a specified folder structure. This node is particularly useful for organizing and managing versioned outputs in a systematic way. By creating directories such as

///v001`` to ``v{value}``, it ensures that subsequent runs of the FolderIncrementer` will continue from the next available version number, v{value+1}. This functionality is beneficial for users who need to skip ahead or reserve a known range of versions, providing a structured approach to version management without manual intervention.

Folder Version Set Input Parameters:

label

The label parameter specifies the folder name under the output directory where the versioned folders will be created. It acts as a categorization tool, allowing you to organize your outputs under different labels. The default value is "default", and it is crucial for maintaining a clear and organized directory structure.

value

The value parameter determines the highest version number to be reserved. It dictates how many version folders will be created, starting from v001 up to v{value}. This parameter allows you to plan ahead by reserving a specific number of version slots. The default value is 1, with a minimum of 1 and a maximum of 999999, providing flexibility in how many versions you wish to reserve.

prefix

The prefix parameter defines the prefix used for version folders. By default, it is set to "v", which results in version folders like v001, v002, etc. This prefix must match what the FolderIncrementer is using to ensure consistency across versioning.

padding

The padding parameter specifies the zero-padding width for the version number. For example, a padding of 3 results in version numbers like v001, v002, while a padding of 4 would produce v0001, v0002. The default is 3, with a minimum of 1 and a maximum of 10. This parameter ensures that version numbers are consistently formatted.

base_path

The base_path parameter allows you to override the base directory where the version folders will be created. If left empty, it defaults to the ComfyUI output directory. This parameter provides flexibility in choosing where your versioned outputs are stored.

date_format

The date_format parameter determines the format of the date used in the folder structure. It must match the format used by the FolderIncrementer. The default format is "MM-DD-YYYY", ensuring that the date is consistently represented in the directory path.

Folder Version Set Output Parameters:

status

The status output provides a message confirming how many placeholder version directories were created. It serves as a confirmation that the node has successfully reserved the specified version slots, giving you feedback on the operation's outcome.

next_version

The next_version output indicates the version number that the next FolderIncrementer run will produce. This output is crucial for understanding the starting point for future versioning, ensuring that there are no overlaps or gaps in the version sequence.

Folder Version Set Usage Tips:

• Ensure that the prefix and padding parameters match those used by the FolderIncrementer to maintain consistency in version numbering.
• Use the base_path parameter to organize outputs in a specific directory structure, especially if you have multiple projects or categories.
• Plan your versioning strategy by setting the value parameter to reserve enough version slots for your anticipated needs.

Folder Version Set Common Errors and Solutions:

"OSError: [Errno 13] Permission denied"

• Explanation: This error occurs when the node attempts to create directories in a location where it does not have the necessary permissions.
• Solution: Ensure that the application has write permissions to the specified base_path or choose a directory where you have the appropriate access rights.

"Invalid date format"

• Explanation: This error arises when the date_format parameter does not match the expected format used by the FolderIncrementer.
• Solution: Verify that the date_format parameter is set to a format that matches the one used by the FolderIncrementer, such as "MM-DD-YYYY".