ChenLab

Apps / image-clicker

ImageClicker v4.3

Windows 10/11 · free · MIT

Overview

See the button. Click the button. Capture a button once, line up the steps, and ImageClicker finds that button on screen and clicks it, even when it moves. Built for chores like clearing the same popup 200 times a day.

Finds by look

Not by position, on any monitor. Tells colors apart and handles zoomed pages.

Chain steps

Image clicks, keys and typed text (Thai works), saved as sets you can switch between.

Local and safe

No AI, no internet. Move the mouse to emergency-stop.

How fast it finds a button

Before the speed-up487 ms
Full-screen search136 ms
Near the last spot (a button it has seen)7.7 ms

Measured on a two-monitor setup, 4,480 px wide. Shorter is faster.

What it can do

  • Finds buttons by how they look, not where they are. Drag a box around a button once; it is found wherever it shows up next, on any monitor.
  • Runs a sequence: image clicks, key presses (enter, esc, ctrl+a…) and typed text. Thai works too.
  • Watch mode (F10): leave it running while you work. The moment the first step's button appears, it runs the whole set, puts your mouse back and keeps watching.
  • Per-step options: left / right / double click, click offset, skip if not found, click every match, verify the click and retry.
  • Fast: about 7.7 ms to find a button it has already seen (it looks near the last spot first), with a full-screen search when it has moved.
  • Careful: color matching tells apart buttons with the same shape, zoom tolerance handles zoomed pages, moving the mouse is an emergency stop, and it beeps when it stops because of a problem.
  • Several sets: keep one per task and switch from a dropdown. Thai / English interface.

How to use

  1. + Image drag a box around the button. Include some text or the button's edge, because a flat color can't be matched.
  2. Add more steps + Image, + Key, + Text. Click a card to edit or reorder it, or to Test whether it can be found.
  3. Start (F9) runs the set: loop, a number of rounds, or once. F9 again stops it.
  4. Watch (F10) waits for step 1 to appear, then runs the set each time it does.

Tips

  • Narrow the search area to one screen or a box you drag. It is faster and makes misclicks rarer.
  • Raise “pause after” on a step if a page is slow to update.
  • Lower accuracy a little if a button is not found. Raise it if the wrong button gets clicked.

Specs

Version
4.3
OS
Windows 10 / 11
Size
about 60 MB (installer)
Speed
about 7.7 ms for a button it has already seen
From source
Python 3.10+ · pip install -r requirements.txt · python image_clicker.py
License
MIT
Source
github.com/chenlab789/image-clicker

Hotkeys

F9
Start / stop
F10
Watch mode on / off
Esc
Cancel a capture or close the set menu

FAQ

Windows says the file is dangerous. What now?

ImageClicker controls the mouse and listens for hotkeys, so Windows and some antivirus tools flag programs like it by mistake. Click “More info”, then “Run anyway”. The full source is open on GitHub, so you can read exactly what it does.

Where are my sets saved?

In the profiles/ and steps/ folders next to the program. Move the folder and your sets come with it.

Does it need internet or AI?

No. Matching is plain image comparison (OpenCV) and everything runs on your machine.

Which systems does it run on?

Windows 10 and 11.

Still stuck? Go to Support →