// troubleshooting guide · keyboard maestro
Keyboard Maestro Click at Found Image Not Working
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 15, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · keyboard-maestro/click-at-found-image-not-working4 FIXES
// quick answer
Found-image actions most often fail because the Engine lacks Screen Recording permission. Grant it to the Engine itself, then re-test with a Screen Capture action.
Most likely fix: Grant Screen Recording to the Engine
How to fix it
// try these in order, the most common fix is first
FIX 1Grant Screen Recording to the Engine
- 01Open System Settings > Privacy & Security > Screen Recording
- 02Enable Keyboard Maestro Engine (add it if absent) as well as Keyboard Maestro
- 03Quit and relaunch the Engine
Did this fix it?FIX 2Toggle the permission
- 01Untick and re-tick Screen Recording for the Engine, then restart it
Did this fix it?FIX 3Verify with Screen Capture
- 01Use a Screen Capture action on a non-Keyboard Maestro window
- 02If the capture is blank, permission is still the problem
Did this fix it?FIX 4Check the log and the image
- 01Read ~/Library/Logs/Keyboard Maestro/Engine.log for the exact message
- 02Re-capture the reference image and raise the fuzz value
Did this fix it?
Symptoms
Click at Found Image or Find Image reports no unique image found, or does nothing after an OS update.
Why it happens
- C-01Screen Recording permission missing for Keyboard Maestro Engine
- C-02Permission ticked but stale
- C-03Reference image no longer matches (theme, scaling, display)
- C-04Fuzz setting too strict
// this guide also covers
- keyboard maestro find image not working
- keyboard maestro click on found image
- keyboard maestro screen recording
Still not working?
If Keyboard Maestro keeps failing, you're not alone. See every Keyboard Maestro problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usThe same problem in other apps
All audio, video & device problems guides →
AutoHotkey Hotkeys Not Working on Non-English Keyboard Layouts (AutoHotkey)
TextExpander Keyboard Not Expanding on iPhone (TextExpander)
PowerToys Keyboard Manager Not Working (Microsoft PowerToys)
Other Keyboard Maestro errors
- Keyboard Maestro Macros Not Firing
- Keyboard Maestro Not Working After macOS Update
- Keyboard Maestro Typed String Trigger Not Working
- Keyboard Maestro Secure Input Blocking Macros
- Keyboard Maestro Engine Not Launching at Login
- Keyboard Maestro Actions Not Working on macOS Tahoe
- Keyboard Maestro Macros Not Saving
- Keyboard Maestro Safari and Chrome Actions Not Working