Differences

This shows you the differences between two versions of the page.

--- action:File_Actions [2023/06/20 10:53] – [Move and/or Rename] peternlewis
+++ action:File_Actions [2024/11/10 06:42] (current) – [How To Use] peternlewis
@@ Line 5: / Line 5: @@
   * Reveal in Finder
   * Create Unique File (v10.0+)
-  * Move (and/or Rename)
+  * Move (v11.0+)
+  * Rename (v11.0+)
+  * Move or Rename
   * Copy
   * Duplicate
@@ Line 12: / Line 14: @@
   * Delete Directory (permanently)
-{{move-rename-action.png?nolink|}}
+Delete is obviously dangerous, and Delete Directory is extremely dangerous. Ensure you have full system backups before using this action.
-Delete File is obviously dangerous, and Delete Directory is extremely dangerous. Ensure you have full system backups before using this action.
 ===== How To Use =====
@@ Line 26: / Line 26: @@
 ^ Option ^ Description ^
 ^ Reveal | brings the Finder to the front with the file or folder selected. |
-^ Create Unique File (v10.0+) | create a new unique file based on the path you supply, adjusting the basename to something unique, and returning the new file path in the specified variable. |
+^ Create Unique File (v10.0+) | create a new unique file based on the path you supply, adjusting the base name to something unique, and returning the new file path in the specified variable. |
-^ Move | moves and/or renames a file or folder. |
+^ Move (v11.0+) | moves a file or folder. |
+^ Rename (v11.0+) | renames a file or folder. |
+^ Move or Rename | moves and/or renames a file or folder. |
 ^ Copy | copies a file or folder. You must specify a name and location for the copy.\\ Since this requires a destination for the copy, if you want to just copy the file to the Clipboard, see [MACRO:   Choose File and Copy It [Example]](https://forum.keyboardmaestro.com/t/choose-file-and-copy-it-example-macro-v9-0-2/15581) |
-^ Delete | deletes a file (but not a folder) with no warnings or confirmation messages. The file is deleted and not moved to the Trash. Be careful with this action. |
 ^ Duplicate | duplicates a file within the same folder and adds // copy// to the filename. |
-^ Trash | moves a file or folder to the Trash from where it can easily be recovered. |
+^ Trash | moves a file or folder to the Trash (on remote volumes, the system may immediately delete the file) |
+^ Delete File | deletes a file (but not a folder) with no warnings or confirmation messages. The file is deleted and not moved to the Trash. Be careful with this action. |
 ^ Delete Directory | Be **extremely careful** with this action as it deletes the folder and all its contents with no warnings or confirmation messages. |
 ==== Move and/or Rename ====
-The option _Move_ allows you to do three different things, based on the data you supply in the _to_ field.  In all cases, the _Source Item Path_ field must be the _full path_ to the source Finder item (file or folder) that is being acted upon.
+The option _Move_or_Rename_ allows you to do three different things, based on the data you supply in the _to_ field.  In all cases, the _Source Item Path_ field must be the _full path_ to the source Finder item (file or folder) that is being acted upon.
 If you specify a folder in the _to_ field (eg `~/Documents/SomeFolder`), the file will be moved to the specified folder.
-If you specify a file name (without any slash `/`) (eg `NewName.jpg`), then file file will be renamed.
+If you specify a file name (without any slash `/`) (eg `NewName.jpg`), then the file will be renamed.
 If you specify a full path to a new location with a new name (optionally the same name) (eg `~/Documents/SomeFolder/SomeName.jpg`), then the file will be moved and renamed.
+The _Move_ option requires the _to_ field to specify an existing folder and moves the specified source file or folder to the new location.
+The _Rename_ option requites the _to_ field to specify only a file name (without any slash `/`) and renames the file or folder without moving it.
 === Overwrite Existing File(s) ===