https://wiki.keyboardmaestro.com/ 2026-05-28T03:33:56+00:00 https://wiki.keyboardmaestro.com/ https://wiki.keyboardmaestro.com/_media/wiki/logo.png text/html 2023-09-15T06:21:26+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Find_Image_on_Screen?rev=1694758886&do=diff Find Image on Screen Action The Find Image on Screen action finds a specified image on the screen in a specified area and stores the image location and fuzziness (left,top,width,height,fuzz) in a Keyboard Maestro Variable. [ Find Image on Screen ] You can specify the image to search based on: text/html 2023-09-15T06:20:06+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Move_or_Click_Mouse?rev=1694758806&do=diff Move or Click Mouse Action The Move or Click Mouse action allows you to move, click or move and click the mouse using any mouse button, and optionally dragging. You can specify modifiers such as the shift key, as well as the position, relative to any corner of the front window, the main screen, or the current mouse location, or a found image on the screen. text/html 2021-05-26T02:10:15+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Resize_Image?rev=1621995015&do=diff Modify an Image Action (Options in Resize an Image Action) There are a variety of actions to modify an image either in the System Clipboard, or in a Named Clipboard. Choose One of the Following Actions from the “Resize” Popup Menu: Action Option Description Resize an Image text/html 2023-09-18T05:14:10+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Stream_Deck_Set_Image?rev=1695014050&do=diff Stream Deck Set Image The Stream Deck Set Image action (v9.0+) allows you to set a Stream Deck button to a specified image. [ Stream Deck Set Image ] You specify the Button ID of the button to change. If two buttons have the same ID, both will change. You can set the button image to: text/html 2015-07-13T10:50:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Composite_onto_Image?rev=1436784629&do=diff The Composite onto Image action allows you to add images, styled text or text tokens onto an existing image which is on the system clipboard or a named clipboard. For example, you could add a date or copyright notice. Select the image from the On image text/html 2023-09-13T03:07:40+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/OCR_Image?rev=1694574460&do=diff OCR Screen or Image The OCR Image action allows you to extract the text from an image using OCR (Optical Character Recognition) (specifically using either Apple Text Recognition (v11+ and macOS 10.15+) or the Tesseract OCR library). [ OCR Image ] The source image can be pasted into the action, or read from the System Clipboard, Trigger Clipboard, a Named Clipboard, or a file, or you can get the image from the screen. text/html 2021-10-14T07:50:20+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Set_Clipboard_to_Image?rev=1634197820&do=diff Set Clipboard to Image The Set Clipboard to Image action allows you to set the System Clipboard, Trigger Clipboard or a Named Clipboard to a specified image. [ Set Clipboard to Image ] You can set the image in the action, from a custom icon (v10.0+), or read the image from the System Clipboard, Trigger Clipboard, a Named Clipboard, or a file, or you can get the image from the screen (which would be the same as the text/html 2019-07-15T03:40:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Set_Desktop_Image?rev=1563162032&do=diff Set Desktop Image The Set Desktop Image action (v9.0+) allows you to set the desktop to a specified image file. [ Set Desktop Image ] The image must remain in the file at that path since the system will potentially reload it (eg after a restart). You can have the image: text/html 2015-07-07T01:12:10+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Create_New_Image?rev=1436231530&do=diff The Create New Image action allows you to create an image of specified dimensions and color and save it to the system clipboard or a named clipboard. Select the color by clicking on the color square and choosing a new color from the Colors palette. Close the palette when you’ve finished. text/html 2020-05-21T07:49:44+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Highlight_Location?rev=1590047384&do=diff The Highlight Location action highlights a location on screen. This can be specially useful for finding the mouse pointer. There are several parameters to set. This will highlight the location that has the top left corner where the mouse is (MOUSEX(), MOUSEY()) and is 100 pixels wide and 100 pixels down. text/html 2015-07-07T02:05:54+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Rotate_Image?rev=1436234754&do=diff The Flip Image and Rotate Image actions allow you to flip or rotate an image on the system clipboard or a named clipboard. Select from the pop-up to: * Flip horizontally. * Flip vertically. * Rotate 90° clockwise . * Rotate 180°. * Rotate 90° counter-clockwise (270°). text/html 2015-07-07T01:29:12+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Draw_Shape_onto_Image?rev=1436232552&do=diff The Draw Shape onto Image action allows you to draw a line, rectangle or oval onto an image on the system clipboard or a named clipboard. Select the shape from the Draw a pop-up. Contextual options appear allowing you to choose parameters such as line color, fill color, thickness, corners, width and height as relevant. text/html 2026-03-26T05:19:54+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Get_a_URL?rev=1774502394&do=diff Get a URL The Get a URL action (v8+) downloads from a specified web location. [ Get a URL ] Output of Results The results can be: * Ignored. * Displayed in a floating window. * Displayed briefly in a Notification. * Displayed large across the screen. text/html 2015-07-07T01:49:39+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Get_Image_Size?rev=1436233779&do=diff The Get Image Size action captures one of several parameters of image dimension to a variable. Select which dimensions to capture from the Get image pop-up: * pixel size. * pixel width. * pixel height. * point size. * point width. * point height. text/html 2022-09-18T02:49:58+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Switch_or_Case?rev=1663469398&do=diff Switch/Case Action The Switch/Case action is used to perform different actions based on different values of a common parameter. It is very similar to the JavaScript Switch statement. The Switch Action is a good alternative to using multiple, nested, If/Then Actions. The actions in the first section that matches will be executed. If no section matches, then no actions will be executed and the execution will continue after the Switch/Case action. Under no circumstances will actions from more t… text/html 2021-10-14T07:48:42+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Set_File_Icon?rev=1634197722&do=diff The Set File Icon action sets the icon of the specified file. You can set the icon from a specific image, from a custom icon (v10.0+), from a clipboard, from an image in a file, or from a screen capture area. Click the File Chooser button to the right of the action to select an existing file on disk. Option-click on the File Chooser button to show the currently selected file in the Finder (assuming it exists already). text/html 2015-07-07T02:14:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Trim_Image?rev=1436235269&do=diff The Trim Image action trims transparent areas from the edge of an image on the system clipboard or a named clipboard. text/html 2023-05-15T04:22:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Write_to_a_File?rev=1684124569&do=diff Write To File Action The Write to a File and Append Text to a File actions allow you to write data from a variety of sources to a file on disk. Write or append the current system clipboard, a named clipboard, a variable, some text or some styled text (you can write but cannot append styled text). text/html 2015-06-30T03:47:22+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Add_or_Remove_Margins?rev=1435636042&do=diff text/html 2019-07-01T01:31:14+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Copy_Clipboard_to_Clipboard?rev=1561944674&do=diff Copy Clipboard to Clipboard The Copy Clipboard to Clipboard action allows you to copy items from one clipboard to another. Select the source and destination clipboards from the Copy and to pop-ups respectively. [ Copy Clipboard to Clipboard ] See Also Actions * Set Clipboard to File Reference action * Set Clipboard to Image action text/html 2015-06-30T03:49:14+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Crop_Image?rev=1435636154&do=diff text/html 2020-12-14T02:56:15+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Display_Clipboard?rev=1607914575&do=diff Display Clipboard Action The Display (Named) Clipboard action displays the system clipboard or a Named Clipboard in a window. Select which clipboard to display from the Display pop-up. This can display an image. You can also display a file by reading the file in to the system clipboard, or in to a named clipboard. text/html 2020-12-14T02:56:22+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Display_Text?rev=1607914582&do=diff Display Text Action The Display Text Action provides two very different functions: * Display Text in a Popup Window * Insert Text in a Text Document or Text Field Action Screenshot When you initially insert this Action, it looks like this: text/html 2026-05-25T12:35:09+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Execute_a_Shell_Script?rev=1779712509&do=diff Execute a Shell Script The Execute a Shell Script action executes a specified shell script using /bin/sh, either from a file or from the script embedded in the action. Important: * It is best to always specify the language using the #! at the front of the script. text/html 2023-09-18T06:43:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Execute_Shortcut?rev=1695019383&do=diff Execute Shortcut The Execute Shortcut (v10.1+) action executes a specified macOS Shortcut (macOS 12.0+). The Shortcut can optionally receive text input from the System or a Named Clipboard, the Trigger Clipboard, a Variable, Text, Calculation or a File. text/html 2015-07-07T02:06:19+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Flip_Image?rev=1436234779&do=diff text/html 2021-09-19T05:35:40+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/OCR_Screen?rev=1632029740&do=diff text/html 2021-10-14T07:53:58+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Prompt_for_File?rev=1634198038&do=diff Prompt for File Action The Prompt for File action (v8+) prompts for selected files or folders and saves the path(s) into a variable. [ Prompt for File ] You can prompt for an existing file(s) or folder(s), or for a new file or folder. You can choose whether you want to select only a single file or folder, or allow selecting multiple files or folders (v10.0+). text/html 2017-03-06T03:25:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Read_a_File?rev=1488770749&do=diff The Read a File action allows you to take the contents of a text or image file and put them on the system clipboard, a named clipboard or in a variable. Click the File Chooser button to the right of the action to select an existing file on disk. Option-click on the File Chooser button to show the currently selected file in the Finder (assuming it exists already). text/html 2015-06-30T03:49:08+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Resize_Canvas?rev=1435636148&do=diff text/html 2015-06-30T03:49:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Resize_Image_to_Fit?rev=1435636143&do=diff text/html 2019-07-09T08:30:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Set_Clipboard_to_File_Reference?rev=1562661017&do=diff Set Clipboard to File Reference The Set Clipboard to File Reference action allows you to set the System Clipboard, Trigger Clipboard or a reference to a file. [ Set Clipboard to File Reference ] See Also Actions * Copy Clipboard to Clipboard action * Set Clipboard to Image action * See all Actions text/html 2016-09-12T05:24:27+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Set_Image_DPI?rev=1473657867&do=diff text/html 2020-01-17T06:21:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Stream_Deck_Set_Title?rev=1579242089&do=diff Stream Deck Set Title The Stream Deck Set Title action (v9.0+) allows you to set a Stream Deck button to a specified title. The button title in the Stream Deck configuration must be empty, otherwise it will override any title set with this action. [ Stream Deck Set Title ] You specify the Button ID of the button to change. If two buttons have the same ID, both will change. text/html 2019-07-15T06:44:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Stream_Deck_Show_Alert?rev=1563173072&do=diff Stream Deck Show Alert The Stream Deck Show Alert action (v9.0+) briefly shows an alert mark on a Stream Deck button. [ Stream Deck Show Alert ] You specify the Button ID of the button to display the alert mark on. If two buttons have the same ID, both will show the marker. The Button ID field is a token text/html 2019-07-15T06:44:25+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Stream_Deck_Show_OK?rev=1563173065&do=diff Stream Deck Show OK The Stream Deck Show OK action (v9.0+) briefly shows a tick mark on a Stream Deck button. [ Stream Deck Show OK ] You specify the Button ID of the button to display the OK marker on. If two buttons have the same ID, both will show the marker. The Button ID field is a token text/html 2021-10-14T04:33:11+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Until?rev=1634185991&do=diff Until Action Definition The Until action executes a list of actions until conditions are met. The Until action condition is not evaluated UNTIL the end of the Until Loop, so it will always execute all Actions in the Until block at least once. It is one of several Actions that