ComfyUI Node: PDIMAGE:Rename

PDIMAGE:Rename:

The PDIMAGE_Rename node is designed to streamline the process of renaming multiple image files efficiently. This node is particularly beneficial for users who need to organize large collections of images by renaming them in a consistent and systematic manner. By allowing you to specify various parameters such as file paths, suffixes, and output formats, the node provides a flexible and user-friendly approach to batch renaming. This capability is essential for maintaining an organized workflow, especially when dealing with numerous images that require uniform naming conventions. The node's primary goal is to simplify the renaming process, saving you time and reducing the potential for errors that can occur when renaming files manually.

PDIMAGE:Rename Input Parameters:

input_folder

This parameter specifies the path to the folder containing the images you wish to rename. It is a required field and helps the node locate the images to be processed. The default value is "input", and it should be a valid directory path.

output_folder

This parameter defines the path to the folder where the renamed images will be saved. It is a required field and ensures that the renamed files are stored in the desired location. The default value is "output", and it should be a valid directory path.

filename

This parameter allows you to specify a new base name for the files. If left empty, the original file names will be retained. This flexibility lets you decide whether to keep the existing names or apply a new naming convention.

suffix

This parameter adds a suffix to the file names, providing an additional layer of customization. The default value is "_", and it can be used to append specific identifiers or version numbers to the file names.

output_format

This parameter lets you choose the format for the output files, with options including "png" and "jpg". The default format is "png", and selecting the appropriate format can be crucial depending on your specific needs for image quality and file size.

max_side_length

This parameter sets the maximum side length for the images, ensuring they do not exceed a specified size. The default value is 2048, with a minimum of 64 and a maximum of 8192, adjustable in steps of 64. This helps in maintaining consistency in image dimensions.

start_number

This parameter determines the starting number for the renamed files, allowing for sequential numbering. The default value is 1, with a range from 1 to 10000, adjustable in steps of 1. This is useful for creating an ordered sequence of images.

PDIMAGE:Rename Output Parameters:

processing_summary

The output of this node is a text summary of the renaming process. This summary provides a concise overview of the actions performed, including the number of files processed and any specific changes made to the file names. It serves as a quick reference to verify that the renaming operation was completed successfully.

PDIMAGE:Rename Usage Tips:

• Ensure that the input_folder and output_folder paths are correctly specified to avoid errors in locating or saving files.
• Use the suffix parameter to add meaningful identifiers to your file names, which can help in categorizing or versioning your images.
• Adjust the max_side_length parameter to maintain uniformity in image dimensions, especially when preparing images for specific display requirements.

PDIMAGE:Rename Common Errors and Solutions:

"Input folder not found"

• Explanation: The specified input folder path does not exist or is incorrect.
• Solution: Verify that the input_folder path is correct and that the directory exists.

"Output folder not found"

• Explanation: The specified output folder path does not exist or is incorrect.
• Solution: Ensure that the output_folder path is correct and that the directory exists or create it if necessary.

"Invalid output format"

• Explanation: The selected output format is not supported.
• Solution: Choose a valid output format, either "png" or "jpg", from the available options.

"File renaming conflict"

• Explanation: A file with the same name already exists in the output folder.
• Solution: Modify the filename or suffix parameters to ensure unique file names, or choose a different output_folder.