Skip to content

Latest commit

 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

ClickSequencer

A lightweight AutoHotkey v2 script that records a sequence of mouse clicks and replays them on demand. Useful for automating repetitive clicking tasks without writing a dedicated script each time.


Requirements

  • AutoHotkey v2.0 or later
  • Windows (uses Win32 APIs for screen and overlay rendering)

Getting Started

  1. Download or clone ClickSequencer.ahk
  2. Double-click the file to run it (AutoHotkey v2 must be installed)
  3. A tray icon will appear and a status toast will confirm it's running

Hotkeys

Key Action
F8 Start recording clicks
F9 Stop recording (first press) / Run the sequence (subsequent presses)
Esc Stop playback mid-sequence

How It Works

1. Recording

Press F8 to enter recording mode. A toast notification appears at the top of your screen confirming you're live. Every left-click you make is captured as a point — its screen coordinates are stored in order.

Each recorded click shows a brief ripple animation and a toast confirming the point number and coordinates. Points are labelled alphabetically (A, B, C …).

Press F9 to stop recording.

2. The Overlay

After recording, a full-screen transparent overlay appears showing your recorded points as coloured dots:

  • Green — first point (A)
  • Red — last point
  • Blue — all points in between

Dashed lines connect the dots in sequence order. You can drag any dot to adjust its position without re-recording — just click and drag it to where you want it.

3. Playback

Press F9 to run the sequence. The overlay hides during playback so clicks pass through cleanly. For each point:

  • A pulsing crosshair animates onto the target
  • The click fires
  • A countdown timer shows how long until the next click

Press Esc at any time to stop. Once finished, the overlay reappears and you can run again (F9) or re-record (F8).


Settings

Right-click the tray icon and choose Settings to adjust the delay between clicks.

Setting Default Minimum
Delay between clicks 800 ms 100 ms

Changes take effect immediately for the next run.


Configuration (in script)

Three constants near the top of the file can be changed directly:

DELAY        := 800   ; milliseconds between clicks
POINT_RADIUS := 14    ; size of the dot on the overlay
PULSE_STEPS  := 12    ; animation frames for the pulse effect

Overlay Details

The overlay is a transparent always-on-top window that sits across your entire virtual screen (including multi-monitor setups). It uses WinSetTransColor to make the background invisible while keeping the dots and lines visible.

Drag handles are implemented via low-level Windows messages (WM_LBUTTONDOWN, WM_MOUSEMOVE, WM_LBUTTONUP) so dragging feels native.


Tray Menu

Right-clicking the system tray icon gives three options:

  • Settings — adjust the click delay
  • (separator)
  • Exit — close the script

Limitations

  • Only left-clicks are recorded (not right-clicks, scroll, or keyboard input)
  • The sequence runs once per F9 press — there is no built-in loop/repeat count (press F9 again to re-run)
  • Coordinates are absolute screen positions, so recordings are resolution and layout dependent
  • The overlay dot rendering uses rectangular controls styled to look circular — on some themes they may appear as squares

File Structure

ClickSequencer.ahk   — the full script, single file, no dependencies

License

MIT — do whatever you want with it. Sell it, fork it, print it out and hang it on your wall. Just don't blame us when you accidentally automate yourself out of a job.

About

Auto Clicker, Record and replay mouse click sequences with a draggable visual overlay, no scripting required.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages