The Found Image condition tests for a matching image on your screen(s) or windows.
Although it is generally better to use high level actions like Press Button or Resize Window action, it is sometimes necessary to resort to looking at the screen for a specific image and responding appropriately (behaving differently if it exists, clicking on it, moving things to it, etc).
There are various actions (Move or Click Mouse, Find Image on Screen, conditions and collections that search the screen for a matching image.
This is how the Action appears when first inserted into your macro.
Remember when specifying the area, as with all numeric fields, the numbers can be calculations including functions, and the fields expand to allow for longer expressions as soon as you type something other than a number, so this allows very precise control of where you can match.
Note that in the above screen shot, the WINDOW(0,Left)
function is referring to the frontmost window in the frontmost app. To refer to other windows in the frontmost app, you need to change the index
parameter of the WINDOW function.
Keyboard Maestro uses a relatively fast search to make the action perform in a reasonable amount of time, but it can result in not finding some images.
When testing found image macros:
See also the Found Images collection, Move or Click Mouse action, and Find Image on Screen action.