ComfyUI Node: JDCN_FileMover

JDCN_FileMover:

The JDCN_FileMover node is designed to streamline the process of moving files from one location to another within your file system. This node is particularly useful for organizing and managing your files efficiently, ensuring that they are relocated to the desired output directory. It supports functionalities such as creating the output directory if it does not exist and handling file overwrites based on user preferences. By automating these tasks, JDCN_FileMover helps you maintain a well-organized file structure, saving you time and reducing the risk of errors associated with manual file management.

JDCN_FileMover Input Parameters:

FilePaths

This parameter expects a list of file paths (as strings) that you want to move. Each file path should be a valid path to an existing file on your system. The node will process each file in this list, moving them to the specified output directory. There is no minimum or maximum value for the number of file paths, but an empty list will result in no action being taken.

OutputDirectory

This parameter specifies the directory path where the files will be moved. If the directory does not exist, the node will create it automatically. The default value is "directory path", but you should provide a valid directory path to ensure the files are moved to the correct location. This parameter is crucial as it determines the destination of the files being moved.

OverwriteFile

This boolean parameter determines whether existing files in the output directory should be overwritten. If set to True, any file in the output directory with the same name as a file being moved will be overwritten. If set to False, the node will rename the file being moved to avoid overwriting existing files. The default value is False, which helps prevent accidental data loss.

JDCN_FileMover Output Parameters:

NewFilePaths

This output parameter returns a list of the new file paths after the files have been moved. Each path in this list corresponds to the new location of a file that was moved by the node. This output is useful for verifying the successful relocation of files and for further processing or referencing the moved files in subsequent operations.

JDCN_FileMover Usage Tips:

• Ensure that the FilePaths parameter contains valid paths to existing files to avoid errors during execution.
• Use the OutputDirectory parameter to specify a clear and organized directory structure for your files, making it easier to locate them after they are moved.
• Set the OverwriteFile parameter to True only if you are certain that overwriting existing files is safe and intentional, to prevent accidental data loss.

JDCN_FileMover Common Errors and Solutions:

Folder does not exist.

• Explanation: This error occurs when the specified output directory does not exist and cannot be created.
• Solution: Ensure that the OutputDirectory parameter is set to a valid directory path and that you have the necessary permissions to create directories in the specified location.

Empty FileName string

• Explanation: This error occurs when the FilePaths parameter is an empty list, meaning there are no files to move.
• Solution: Provide a list of valid file paths in the FilePaths parameter to ensure that there are files to be moved.

Error: <specific error message>

• Explanation: This error occurs when there is an issue during the file moving process, such as permission issues or invalid file paths.
• Solution: Check the specific error message for details and ensure that all file paths are valid and that you have the necessary permissions to move the files.