This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
Actions [2016/02/07 23:36] JMichaelTX ADD section on export/import of Actions |
Actions [2020/11/01 19:46] JMichaelTX [How To Use] |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | {{:macro-action-icon.png?nolink |}} | ||
====== Macro Actions ====== | ====== Macro Actions ====== | ||
- | Keyboard Maestro has a very large number of actions. Each action describes what you want done. A macro includes of a sequence of actions. | + | ===== Definition ===== |
- | See the [List of Actions](#List_of_Available_Actions) below, or the [Keyboard Maestro Documentation](http://www.keyboardmaestro.com/documentation/7/actions.html) for more information on actions and how to use them. | + | **An **//Action//** in Keyboard Maestro is a specific process step (usually of limited scope) to be taken in a Keyboard Maestro [[manual:Macros|Macro]].** If a process consists of a series of steps, then an **//Action//** would be one step. A Macro may contain one or more **//Actions//**. |
- | ===== Plugin Actions ===== | + | ===== Actions Listed by Category ===== |
- | Keyboard Maestro also supports user-defined Actions, which are called "[Plug In Actions](https://www.keyboardmaestro.com/documentation/7/pluginactions.html)". See that link in the Documentation for details. | + | ==== Looping Actions ==== |
+ | Actions that _loop_ through a set of other Actions until some criteria is met. | ||
+ | |||
+ | * [[action:For_Each|For Each]] | ||
+ | * [[action:Repeat|Repeat]] | ||
+ | * [[action:Until|Until]] | ||
+ | * [[action:While|While]] | ||
+ | |||
+ | |||
+ | ===== Actions Listed Alphabetically ===== | ||
+ | |||
+ | |||
+ | ~~NOCACHE~~ | ||
+ | <nspages action -textPages=""> | ||
+ | |||
+ | ===== How To Use ===== | ||
+ | |||
+ | Keyboard Maestro has a very large number of actions, some very specific, others more general. The most general **//Actions//** are those which [[Scripting|Execute a Script]], which, of course, can be as specific or general as you like. | ||
+ | |||
+ | See the [List of Actions](#List_of_Available_Actions) below, or the [Keyboard Maestro Documentation](/manual/Macro_Actions) for more information on actions and how to use them. | ||
+ | |||
+ | ===== How To Add an Action to a Macro ===== | ||
+ | |||
+ | **There are a number of ways to add an **//Action//** to a Macro.**\\ | ||
+ | Some of these are: | ||
+ | * Drag and Drop from Action List to Macro | ||
+ | * Double-click on Action in Action List | ||
+ | * Insert Action using the Keyboard Maestro Edit ➤ Insert Action menu | ||
+ | * Insert Action using the Editor shortcut key <key>⌘</key><key>⌃</key>**A** Edit ➤ Insert Action by Name | ||
+ | * Paste in actions copied from elsewhere | ||
+ | * Import an exported list of actions (perhaps downloaded from the forum). | ||
+ | |||
+ | **Here is a demo showing the first two methods:** | ||
+ | |||
+ | {{:km-7.1-add-action-to-macro.an.gif?nolink|}} | ||
+ | |||
+ | ===== Testing for Success or Failure of an Action ===== | ||
+ | |||
+ | **You can use the [[token:ActionResult|ActionResult token]] to test for success or failure of the immediate past action.** | ||
+ | * **If Successful**, Then "**//OK//**" is returned. | ||
+ | * Otherwise, a message describing the reason for failure is returned. | ||
+ | |||
+ | See the [[token:ActionResult|ActionResult token]] for details. | ||
===== Export/Import Actions ===== | ===== Export/Import Actions ===== | ||
Line 18: | Line 59: | ||
- Note that unlike import of Macros, import of Actions inserts the Actions in the currently selected Macro. It does NOT put these Actions into the Action List. | - Note that unlike import of Macros, import of Actions inserts the Actions in the currently selected Macro. It does NOT put these Actions into the Action List. | ||
- | ===== List of Available Actions ===== | + | ===== Plugin Actions ===== |
+ | Keyboard Maestro also supports user-defined Actions, which are called **//Plug In Actions//**.\\ | ||
+ | For details on creating, installing, and using, see | ||
+ | * [Keyboard Maestro Documentation for Plug In Actions](/manual/Plug_In_Actions). | ||
+ | * [Plug In Actions: How to Create, Post, Install ](https://forum.keyboardmaestro.com/t/plug-in-actions-how-to-create-post-install/80) in the Keyboard Maestro Forum. | ||
- | ~~NOCACHE~~ | + | ===== See Also ===== |
- | <nspages action -textPages=""> | + | |
- | + | ||
- | ---- | + | |
Keywords: Plugin, Plugins, Plug-In, User Actions | Keywords: Plugin, Plugins, Plug-In, User Actions | ||
+ | |||
+ | ==== Forum ==== | ||
+ | |||
+ | - [[https://forum.keyboardmaestro.com/t/feature-request-find-all-uses-of-an-action/3626/2|[Feature Request?] Find all uses of an action]] |