How to use it

1. Requirements

• Python installed on your computer (3.9 or newer). Get it from python.org if you don't have it. During installation, check "Add Python to PATH."
• That's it — every other package installs itself the first time you run the app.

2. Running the app

Windows (easiest)

1. Unzip the folder anywhere — your Desktop is fine.
2. Double-click Run AutoClicker.bat.
3. A console window may flash briefly the first time while packages install. After that, the app opens.

Any OS (terminal)

cd path/to/autoclicker
python autoclicker.py

Keep autoclicker.py, assets/, and Run AutoClicker.bat together in the same folder — don't move the script out on its own.

3. Using the app

Clicks per second (CPS)

Type a number from 1–100 in the box, or use the ▲ / ▼ arrows next to it. This controls how fast the auto-clicker fires while running.

Click mode

• Normal — clicks at a perfectly steady rate.
• Jitter — adds slight randomness so clicks read as human, not robotic.

Mouse button

Choose which button gets clicked: Left, Right, or Middle.

Click location

• Current position (default) — clicks wherever your mouse cursor currently is.
• Pick location — locks clicking to one fixed spot on screen.

1. Select Pick location.
2. Click ⊕ Pick point on screen.
3. The app window hides — click anywhere on your screen.
4. The app reappears showing the locked X / Y coordinates.

Hotkeys

Default: F6 to start, F7 to stop — these work even if the app window isn't focused.

1. Click the Start: or Stop: button under Hotkeys.
2. It will say "Press any key…" — press the key you want to bind.
3. It updates immediately. You can't bind the same key to both Start and Stop.

Starting / stopping

• Click ▶ Start or press your Start hotkey to begin clicking.
• Click ■ Stop or press your Stop hotkey to stop.
• The status pill shows ● Idle or ● Running, and the Start/Stop buttons grey out to match.

Theme

Toggle Dark mode near the bottom to switch between dark and light appearance.

4. Closing the app

Just close the window normally (the X button). It cleans up its background threads automatically — no lingering processes.

5. Troubleshooting

Problem	Fix
"python is not recognized"	Python isn't on PATH — reinstall Python and check "Add to PATH."
App opens but hotkeys/clicking don't work	pynput failed to install — run pip install pynput manually, or check your antivirus isn't blocking it.
Nothing happens when I press Start	Make sure a mouse button and CPS value are set — check the status pill for an error message.
Antivirus flags the app	Common for auto-clickers since they simulate input. Only allow it if you trust the copy you downloaded.