Auto Clicker

Download and details: protagonistlabs.app/autoclicker

A free Windows clicker with a global hotkey, multi-point routes, and scripted sequences that can wait for something to appear on screen before they act.

• One click, one hotkey — an interval down to 1 ms, a global hotkey that works from any window, random intervals so a long run doesn't land on the same beat every time.
• Routes — click a list of saved points in order, not just the cursor.
• Sequences — a small step tree: click, move, delay, loop (fixed count or until stopped), and conditions.
• Image detection — capture a piece of the screen and wait for it to reappear before clicking, or branch on whether it's there (OpenCV template matching under the hood).
• Profiles, and saved/loadable sequences as plain JSON.

Everything above is free. There's no license key and no Pro tier.

Running from source

pip install PySide6-Essentials opencv-python numpy
python autoclicker.py

Windows only — it talks to user32/gdi32/dwmapi directly through ctypes for input, the global hotkey, acrylic window effects, and screen capture.

Building the .exe

.venv/Scripts/python -m PyInstaller --noconfirm autoclicker.spec --distpath . --workpath build

autoclicker.spec takes the version from VERSION in autoclicker.py and writes it, with Protagonist Labs as the company, into the exe's version resource. It never packs with UPX.

.venv is a build environment whose PyInstaller has a bootloader compiled here from source, not the prebuilt one every PyInstaller app shares (antivirus engines learn that one from malware built with it). To set it up once (Python 3.11, PySide6 installed, MSVC build tools):

python -m venv --system-site-packages .venv
.venv/Scripts/python -m pip download pyinstaller==6.20.0 --no-binary :all: --no-deps -d .venv/src
tar xzf .venv/src/pyinstaller-6.20.0.tar.gz -C .venv/src
cd .venv/src/pyinstaller-6.20.0/bootloader && ../../../Scripts/python ./waf all --target-arch=64bit
cd .. && ../../Scripts/python -m pip install --no-deps .

Project layout

File	What it is
autoclicker.py	the window, tabs, hotkey capture, profiles
engine.py	the step model and the thread that runs a sequence
editor.py	the step dialog, the sequence tree, the screen/image pickers
winapi.py	everything that talks to Windows directly
store.py	settings, profiles and captured images on disk, in %APPDATA%\ProtagonistLabs\Auto Clicker (moved there from %APPDATA%\AutoClicker at the first start of 1.1.0)
whatsnew.py, whatsnew.txt	the What's new window and its notes, built into the exe
theme.py	the one stylesheet
site/	the presentation page — page.template.html is the source, build_page.py inlines screenshots/ into site.html

More from Protagonist Labs

• HotkeyScan: finds which program already holds a hotkey, free. Auto Clicker lists its own hotkey, and whether it holds it right now, in its card under %APPDATA%\ProtagonistLabspps\, so HotkeyScan can tell when two of our apps want the same keys.
• Shelf: every PC game from every launcher in one library.
• All apps: Windows apps that each do one job properly.