This function is used to copy files to a calculated path.
Choose if you want the files copied to an specified base path or to a base path relative to the folder containing the file being copied. Relative paths are specified by the number of levels up from the file's containing folder. Zero levels implies that the new folder structure should be in the files's containing folder. One level implies that the new folder structure should be in the parent of the file's containing folder, etc.
A specified path may contain any of the escape sequences described in Escape Sequences. At runtime the path must resolve to be:
Warning: be careful when copying files beneath the original folder while batch processing! If you are moving files into a folder which has already been marked for traversal, it is possible that the files will be processed multiple times.
Choose up to three fields to be used as folders to be appended to the absolute or relative base path. When the path is constructed if you specified Album Artist and the field is empty, Artist will be used. If the value associated with a chosen field is empty an error will be issued unless a placeholder is specified.
You can also elect to specify a rename template. If a template is not specified, the original filename will be appended to the destination path. If a template is specified it will be applied. If the template contained a Folder Start construct, the constructed folder will be appended to the path. The constructed filename with the original filename extension will then be appended to the path. The rename template can be chosen from the popup list or manually entered. The only reason to manually enter the template name is if you wish to specify the name at runtime. The template field may contain any of the escape sequences described in Escape Sequences.
To summarize the destination location is calculated as follows:
You can change all spaces in the resultant path to underscore (_) characters by checking the Spaces to _ option.
Yate, will create the final path if it doesn't exist.
By default, the function will always be performed. You can specify to only perform the function if it is part of a compilation or not part of a compilation. This facilitates having two different back to back Move steps. One which handles the non compilation state and one which handles the comilation state.
You can specify what to do if a file already exists at the destination. You can choose to perform the default operation or to skip the move or always replace the existing file. The default operation while not Batch Processing is to be presented with a dialog where you can choose what to do. The default operation while Batch Processing is to log an error message. Note that while Batch Processing, default and skip are identical.
The function sets the Retained Path 1 property to the destination path on success. The Retained Path 2 property is set to the source file's path on success. On failure, both properties are emptied.
You can preview the function's application based on the files currently selected in the main window. The results are displayed in the Log Viewer.