This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
Actions [2016/06/23 02:26] peternlewis [How To Use] |
Actions [2025/02/04 21:36] (current) peternlewis [See Also] |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | {{:macro-action-icon.png?nolink |}} | ||
====== Macro Actions ====== | ====== Macro Actions ====== | ||
===== Definition ===== | ===== Definition ===== | ||
- | **An **//Action//** in Keyboard Maestro is a specific process step (usually of limited scope) to be taken in a Keyboard Maestro [[Macros|Macro]].** If a process consists of a series of steps, then an **//Action//** would be one step. A [[Macros|Macro]] may contain one or more **//Actions//**. | + | **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//**. |
+ | ===== Actions Listed by Category ===== | ||
- | ---- | + | ==== 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]] | ||
+ | |||
+ | ==== User Interface (UI) Actions ==== | ||
+ | |||
+ | App UI Elements | ||
+ | |||
+ | * Insert Text by Typing | ||
+ | * Manipulate a Window | ||
+ | * Move a Window | ||
+ | * Move and Resize a Window | ||
+ | * Move or Click Mouse | ||
+ | * Press a Button | ||
+ | * Select or Show a Menu Item | ||
+ | * Type a Keystroke | ||
+ | |||
+ | Web Browser UI Elements\\ | ||
+ | (Offered for "Front Browser", "Safari", and "Chrome") | ||
+ | |||
+ | * Click Front Browser Link | ||
+ | * Find Image on Screen | ||
+ | * Focus Front Browser Field | ||
+ | * Previous Front Browser Tab | ||
+ | * Select Front Browser Field | ||
+ | * Select Front Browser Tab | ||
+ | * Set Front Browser Checkbox | ||
+ | * Set Front Browser Field to Text | ||
+ | * Set Front Browser Radio Button | ||
+ | |||
+ | System UI Elements | ||
+ | |||
+ | * Set Keyboard Layout | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== Actions Listed Alphabetically ===== | ||
+ | |||
+ | |||
+ | ~~NOCACHE~~ | ||
+ | <nspages action -textPages=""> | ||
===== How To Use ===== | ===== How To Use ===== | ||
Line 14: | Line 59: | ||
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. | 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.**\\ | **There are a number of ways to add an **//Action//** to a Macro.**\\ | ||
Some of these are: | Some of these are: | ||
- | * Drag and Drop from Action List to Macro | + | * Choose Action from the Action List (Actions ➤ Show Actions menu) |
- | * Double-click on Action in Action List | + | * 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 Keyboard Maestro Edit ➤ Insert Action menu | ||
- | * Insert Action using the Editor shortcut key <key>⌘</key><key>⌃</key>**A** Edit ➤ Insert Action by Name | + | * Insert Action by Name |
+ | * Show using the Editor shortcut key <key>⌘</key><key>⌃</key>**A** | ||
+ | * Or from the menu Edit ➤ Insert Action by Name | ||
* Paste in actions copied from elsewhere | * Paste in actions copied from elsewhere | ||
* Import an exported list of actions (perhaps downloaded from the forum). | * Import an exported list of actions (perhaps downloaded from the forum). | ||
Line 27: | Line 77: | ||
{{:km-7.1-add-action-to-macro.an.gif?nolink|}} | {{:km-7.1-add-action-to-macro.an.gif?nolink|}} | ||
- | |||
- | |||
- | ---- | ||
===== Testing for Success or Failure of an Action ===== | ===== Testing for Success or Failure of an Action ===== | ||
Line 38: | Line 85: | ||
See the [[token:ActionResult|ActionResult token]] for details. | See the [[token:ActionResult|ActionResult token]] for details. | ||
- | |||
- | ---- | ||
===== Export/Import Actions ===== | ===== Export/Import Actions ===== | ||
Line 48: | Line 93: | ||
- The Import Actions command in the File menu lets you select a saved action file and **imports the actions it contains into the current macro**. | - The Import Actions command in the File menu lets you select a saved action file and **imports the actions it contains into the current macro**. | ||
- 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. | ||
- | |||
- | |||
- | ---- | ||
===== Plugin Actions ===== | ===== Plugin Actions ===== | ||
Line 56: | Line 98: | ||
Keyboard Maestro also supports user-defined Actions, which are called **//Plug In Actions//**.\\ | Keyboard Maestro also supports user-defined Actions, which are called **//Plug In Actions//**.\\ | ||
For details on creating, installing, and using, see | For details on creating, installing, and using, see | ||
- | * [Keyboard Maestro Documentation for Plug In Actions](https://www.keyboardmaestro.com/documentation/7/pluginactions.html). | + | * [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. | * [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. | ||
+ | ===== See Also ===== | ||
- | ---- | + | === Topics === |
+ | * [[:Macro Groups|Macro Groups]] | ||
+ | * [[:Text Fields|Text Fields]] | ||
+ | * [[:Frequently Asked Questions|FAQ]] | ||
+ | * [[:Fundamental Concepts]] | ||
- | ===== List of Available Actions ===== | + | === Triggers === |
+ | * [[:Triggers|Triggers]] | ||
- | ~~NOCACHE~~ | + | === Conditions === |
- | <nspages action -textPages=""> | + | |
- | ---- | + | * [[:Conditions|See all Conditions]] |
- | Keywords: Plugin, Plugins, Plug-In, User Actions | + | === Functions === |
- | ===== See Also ===== | + | * [[:Functions|See all Functions]] |
- | ---- | + | === Tokens === |
- | ---- | + | * [[:Tokens|See all Tokens]] |
==== Forum ==== | ==== Forum ==== | ||
- [[https://forum.keyboardmaestro.com/t/feature-request-find-all-uses-of-an-action/3626/2|[Feature Request?] Find all uses of an action]] | - [[https://forum.keyboardmaestro.com/t/feature-request-find-all-uses-of-an-action/3626/2|[Feature Request?] Find all uses of an action]] | ||
- |