Keyboard Maestro Wiki

**This is an old revision of the document!**

The Found Images collection lists all the locations that the image matches on the screen (v7.0+).

You specify the image to match (usually got with a Command-Control-Shift-4 screen capture) by pasting an image into the image well. You also specify the amount of fuzziness allowed — because of transparency and anti-aliasing, almost all screen matches are fuzzy to some degree, but usually about 20% is a good place to start.

You can optionally display all the matches on the screen which can be helpful in determining the right amount of fuzz to use.

You can search for the image on:

• all screens.
• the main screen.
• the specified screen (counting from the left).
• the front window.
• the window with a specified title.
• the window with a title containing a given string.
• the window with a title matching a given regular expression.
• the specified window (counting from the frontmost window).
• a specified area on the screen.

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.

You can order the matches by best matches first, top to bottom or left to right.

The result, stored in the For Each action variable is the rectangle containing the match followed by the fuzz of the match (0-100), ie, (left,top,width,height,fuzz).