User Tools

Site Tools


action:File_Actions

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
action:File_Actions [2019/06/25 03:34]
peternlewis
action:File_Actions [2024/01/29 03:38] (current)
peternlewis
Line 3: Line 3:
 This Action is actually a multipurpose Action that provides the following Options: This Action is actually a multipurpose Action that provides the following Options:
 (Most Options can be used with either a File or Folder, except as indicated.) (Most Options can be used with either a File or Folder, except as indicated.)
-  * Move (and/​or ​Rename)+  ​* Reveal in Finder 
 +  * Create Unique File (v10.0+) 
 +  ​* Move (v11.0+) 
 +  * Rename ​(v11.0+) 
 +  * Move or Rename
   * Copy   * Copy
   * Duplicate   * Duplicate
   * Move to Trash   * Move to Trash
   * Delete File (permanently)   * Delete File (permanently)
-  * Reveal in Finder 
   * Delete Directory (permanently)   * Delete Directory (permanently)
  
-{{:action:​move-rename-action-km-7.3.png?​nolink|}}+Delete is obviously dangerous, and Delete Directory is extremely dangerous. Ensure you have full system backups before using this action.
  
 ===== How To Use ===== ===== How To Use =====
  
-You can either insert ​the main Action (shown above), and then choose the actual ​action to use in the dropdown, OR, insert one of the preconfigured Actions from the Action panel/​menu:​ +Select ​the action ​you wish to perform.
- +
-{{:​action:​file-actions-km8.png?​nolink|}}+
  
 Click the File Chooser button on the right of an action to select an existing file or folder on disk. Option-click on the File Chooser button to show the currently selected file or folder in the Finder (assuming it exists already). Click the File Chooser button on the right of an action to select an existing file or folder on disk. Option-click on the File Chooser button to show the currently selected file or folder in the Finder (assuming it exists already).
Line 24: Line 25:
  
 ^ Option ^ Description ^ ^ Option ^ Description ^
-Copy copies a file or folder. ​You must specify ​a name and location for the copy. | +Reveal ​brings the Finder to the front with the file or folder ​selected
-Delete ​deletes ​a file (but not a folder) with no warnings ​or confirmation messagesThe file is deleted ​and not moved to the TrashBe careful with this action. |+^ Create Unique File (v10.0+) | create ​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 (v11.0+) ​moves a file or folder. | 
 +^ Rename ​(v11.0+) | renames ​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) ​|
 ^ Duplicate | duplicates a file within the same folder and adds // copy// to the filename. | ^ Duplicate | duplicates a file within the same folder and adds // copy// to the filename. |
-^ Move | moves and/or renames a file or folder. | 
-^ Reveal | brings the Finder to the front with the file or folder selected. | 
 ^ 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 from where it can easily be recovered. |
 +^ 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. | ^ 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 ==== ==== Move and/or Rename ====
  
-{{:​action:​move_finder_item_action_-_km8.png?​nolink|}}+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.
  
-This Action Option can be confusing because although the Option popup shows only _Move_, it in fact **allows ​you to do three different things, based solely 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.  To add further confusion, the Action Title remains constant at "Move or Rename"​ regardless of the actual operation to be performed.+If you specify a folder ​in the _to_ field (eg `~/​Documents/​SomeFolder`), the file will be moved to the specified ​folder.
  
-=== Operations Available ===+If you specify a file name (without any slash `/`) (eg `NewName.jpg`),​ then file 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.
  
-^ Operation ^ Description ^ To Field ^ Example ^ +The _Move_ option requires ​the _to_ field to specify an existing folder ​and moves the specified source file or folder ​to the new location
-^ Move _Only_ | Moves the Item to a Different Folder, ​and keeps the same Item Name | Full Path to the existing Destination _Folder_ | ~/​Documents/​SomeFolder | + 
-^ Rename _only_ | Renames the Item, which stays in its original Folder | Can be either just the _new_ Item Name (including extension, if any)\\ OR Can be the full path to the item with its _new_ name| Some New File Name.txt | +The _Rename_ option requites ​the _to_ field to specify only file name (without any slash `/`) and renames ​the file or folder without moving it.
-^ Move _and_ Rename | Moves the Item to a Different Folder with a _new_ name | Must be the _Full Path_ to the Item,  with its _new_ Item name and existing Destination Folder. | ~/​Documents/​SomeFolder/​Some New File Name.txt |+
  
 === Overwrite Existing File(s) === === Overwrite Existing File(s) ===
Line 51: Line 55:
  
 ===== See Also ===== ===== See Also =====
- 
----- 
  
 === Actions === === Actions ===
action/File_Actions.1561448064.txt.gz · Last modified: 2019/06/25 03:34 by peternlewis