Short answer
Choose a small, distinctive image and limit the search to the part of the screen where it belongs. Test once with the image visible and once with it absent.
Image detection reads visible pixels. It does not understand what a button means or prove that the app behind it is ready.
When to use this method
Use a visual condition when fixed coordinates are unreliable. A match can change with display scaling, theme, animation, layout or the selected region.
Image and color matchingHow a fresh match controls the chosen branch and when to recapture a target.
- How it works
- A workflow can use one or more image or color targets, wait for appearance or disappearance and run a chosen action only from a fresh verified match.
- Important limit
- When a button changes size, theme or animation state, capture a new template before replay because the saved pixels no longer describe the target.
Choose image detection or color detection
Use image detection for a recognizable shape, icon or label. Use color detection when a pixel or small color group is the clearest signal. Load an image from a file or the clipboard. Use Counter Reader, not an image target, for a changing number or clock.
Build your first image condition
1. Choose a distinctive target
Put one harmless, distinctive image in a test window. Use a small icon or label that does not move or change. Avoid clocks, animation, cursors and changing text.
2. Add the target image
Open Image Detection. Add the target from a file or the Windows clipboard. You should see a preview of the same image in the target list.
3. Select a small search area
Choose a rectangle that contains the target and little else. You should see the selected area outlined on the visible screen. Keep the test window open and in the same place.
4. Keep the first match simple
Use one target at its normal size and color. Keep the default confidence and match mode for the first test. Choose Best if the target can appear more than once.
5. Add a finite timeout
Choose Timeout instead of Until found. Put a harmless Delay in THEN and Stop in ELSE. A finite timeout lets you test both the found and not-found results.
6. Test with the image visible
Run the condition while the target is inside the selected area. You should see the THEN action run.
7. Test with the image absent
Hide the target or move it outside the selected area. Run the condition again. You should see the timeout finish and the ELSE action run. No old target position should be reused.
Advanced matching choicesScale, color, multiple targets and wait behavior.
Use a scale range only when the same target genuinely changes size. Appearance emphasizes the full look, Outline emphasizes shape and Hybrid combines both. Grayscale can help when color is irrelevant. Confidence controls how close a result must be.
With several targets, choose whether any one is enough or all must be present in the same scan. If several matches exist, select the first, best, nearest or a specific numbered match. Use disappearance only when the target leaving the screen is the real signal.
A single scan checks once. Timeout keeps checking until the set time ends. Until found has no finite no-match result for ELSE. A click on a found image uses the fresh verified position. A failed or disappearance result clears the old position instead of reusing it.
Checkpoint: prove match and non-match
Keep the action harmless. Run one scan with the target visible and another with it absent. Continue only if THEN and the timed no-match path behave differently and no old coordinates are reused.
Input Variation never changes which target is selected or where an Image Detection match is clicked. For this step, it can only make small timing changes within the limits you set. It cannot bypass bot protection.
What can break a match
- Display scaling or a different monitor
- Dark mode, hover states, animation or transparent edges
- A search region that is too large or no longer aligned
- Several similar targets without a deliberate match selector
Detection checks
- Test one expected match and one expected non-match.
- Confirm the action targets the intended window.
- Test a timeout or ELSE path without clicking stale coordinates.
- Keep F12 available as the permanent Emergency Stop.
Osenpa Auto Clicker
Combine editable input steps with multi-scale image matching, color targets, THEN or ELSE branches, loops and supervised scheduling.