TrayClick

TL;DR

A tiny Windows tray auto clicker. TrayClick sits in the notification area with no main window. Press the keybind (default F6) and it clicks at your cursor at the set interval (default 100 ms), indefinitely, until you press the keybind again. Right-click the tray icon for a menu with exactly six options: Pause/Resume, Set Keybind, Set Interval, Start with Windows, Credits, and Exit; left-click it to open the settings window. That's the whole program.

• Windows 10 or later, x64
• One small executable (installer or portable); the keybind and interval are all you have to set
• The keybind and interval you pick are remembered between runs (data\config.json next to the exe)

Download

Every release provides two downloads, plus a SHA256SUMS.txt checksum file:

• Installer — TrayClick-v<version>-x64-Setup.exe: per-user install (no admin), Start menu shortcut, uninstaller in Windows Settings. Your settings survive uninstall; they're in a data folder next to the exe, which the installer and uninstaller never touch.
• Portable zip — TrayClick-v<version>-x64-Portable.zip: trayclick.exe, the README, the license, and a short portable note. No install — unzip, run the exe from anywhere.

The builds are unsigned, so Windows SmartScreen may warn on first run: "More info" → "Run anyway".

How to use

1. Run TrayClick (installed shortcut, or the portable exe). It appears in the system tray (notification area) — you may need the ^ overflow arrow the first time.
2. Press F6 to start auto-clicking at the cursor. Press F6 again to stop.
3. Right-click the tray icon for the menu (left-click opens the settings window directly):
   • Pause — stops clicking immediately and ignores the keybind. The item becomes Resume; resuming does not restart clicking until you press the keybind again.
   • Set Keybind [F6] — opens a small window; press any key to make it the new toggle key (Esc cancels). The primary mouse buttons can't be assigned, but the side buttons (X1/X2) can. Assigning a key never starts clicking by itself — clicking starts when you press the new keybind again.
   • Set Interval [100 ms] — opens the settings window: charcoal with red accents, a top bar (hotkey, interval box, Start/Stop), and three pages (switched from a footer row). Clicking: 1 ms and 100 ms preset buttons or a custom interval (1–60000), the mouse button (left, right, or middle), jitter (varies each interval by up to ±10%), the mode (Click; Hold — the keybind holds the button down until pressed again; or Momentary — clicking runs only while the keybind is held), the target (Follow the cursor, Locked to a fixed point, or a Sequence of points), an auto-stop limit (stop after N clicks or N seconds per run, whichever comes first; 0 = no limit), start on launch (clicking begins when TrayClick starts, click mode only), a stop-only key (a second binding that only stops), optional registered hotkeys instead of polling, a delayed start (begin clicking in N minutes), a foreground-app rule (cycles run only while a chosen app is in front; pick it from your running windows), and fullscreen auto-pause. Action: the click action — Single, Double, a Burst of up to 100 clicks with a configurable gap, Scroll (wheel notches per cycle), Key (repeats a captured keystroke), or Drag (presses at one point you pick on screen and glides to another) — a button-down time (how long each click holds the button, 0–1000 ms), alternating buttons (consecutive clicks alternate Left/Right), a random interval range (each cycle picks between the interval and a max), and a speed ramp (the interval eases to a target over the first seconds of each run). Targeting: pick the lock point by clicking anywhere on screen, save it into named slots, jump it to the other monitor's centre, make it follow its window (window-relative), add a pixel offset, a pixel check (click only while a watched pixel keeps its colour), and a region guard (stop the run when the screen around the point changes).
   • Start with Windows — checked when TrayClick is set to launch at sign-in (per-user, no admin). Uncheck to stop launching. If you use the portable exe, the entry points at wherever the exe is, so moving it means toggling this once more.
   • Credits — version, current settings, and how many clicks this session has fired.
   • Exit — removes the tray icon and quits.

While clicking is on in the default Follow target, clicking follows your cursor — it clicks wherever the pointer currently is, at the set interval, including if you move it. With the Locked target, each click jumps to the lock point (one you picked on screen, or the spot where clicking started if you never picked one), clicks, and puts your cursor back where you left it, so you can keep working elsewhere. With the Sequence target, clicks rotate through up to four points you picked, one per cycle. In Hold mode the keybind holds the button down instead — and every way of stopping (keybind, Pause, a dialog, the failsafe, Exit) releases it. You can always tell it's on: the tray icon blinks (alternating with an inverted red icon) and its tooltip shows the click count or the held button.

Safety: while clicking is on, slam the mouse into the top-left corner of the screen to stop clicking instantly — handy at fast intervals, before you reach for the keybind.

Notes

• Only one copy runs at a time; starting a second copy just tells you it's already running. Unless you give it a command: TrayClick.exe --start, --stop, or --toggle forwards the command to the running copy and exits (with no copy running, --start/--toggle launch it already clicking). --profile <name> forwards a profile name the same way — profiles arrive in v1.0.0.
• TrayClick clicks with the standard Windows SendInput API at the current cursor position. It does not move the cursor or record anything; the update check below is its only network use, and everything else works completely offline.
• Updates: at each launch, TrayClick checks GitHub for the latest release. If a newer version exists, a small window in the settings window's charcoal-and-red style offers it — Download opens the release page in your browser, and nothing is ever downloaded or installed automatically. There is no setting for the check; it simply runs at every launch, and offline it quietly does nothing.
• The click interval defaults to 100 ms and can be set to 1 ms, 100 ms, or any custom value from 1 to 60000 ms in the Set Interval window. Very small intervals click as fast as Windows can deliver them; the effective rate is bounded by the OS timer and message delivery.
• Settings — keybind, stop key, hotkey mode, interval, mouse button, jitter, mode, target, lock point, sequence points, named slots, click offset, pixel check, region guard, foreground app, fullscreen pause, auto-stop limits (clicks and seconds), start-on-launch, action, burst count/gap, button-down time, alternation, scroll amount, repeat key, drag points, random range, and ramp — are saved in data\config.json next to the exe and survive restarts. Config files from every earlier version load unchanged, and a config left by an earlier version at the old location (%APPDATA%\TrayClick\config.json) is copied to the new one automatically on first run. To delete your settings completely, run trayclick.exe --clean. (The delayed start is the one exception: it's a one-shot countdown and is never saved.)
• TrayClick is per-monitor DPI aware, so locked-position clicks land exactly on scaled (e.g. 150%) displays.

Screenshots

The tray menu (captured on v0.3.1; v0.4.0 adds a sixth item, Start with Windows), with the current keybind and interval shown in brackets:

The settings window (captured on v0.3.1; it has grown since — 0.4.0 added the mouse-button row and jitter toggle, 0.5.0 the mode/target row, the auto-stop limit, and start-on-launch, 0.6.0 the click-action section, 0.7.0 the repeat-key/drag buttons and the timing section, 0.8.0 split it into Clicking / Action / Targeting tabs, and 0.11.0 gave it the charcoal theme, the top bar, footer page buttons, and the seconds auto-stop limit):

More captures from a real run are on the way; see docs/screenshots/CAPTURE.md for the exact shots still needed.

Build from source

cargo build --release
cargo test

Requires a current stable Rust toolchain on Windows. The icon in assets/icon.ico is embedded as a Windows resource at build time; regenerate it with python3 assets/make_icon.py (needs Pillow).

Reusing the core

The trayclick library in src/lib.rs contains state, configuration formatting, timing and input-ownership policies. The Windows application in src/main.rs provides input, UI, persistence and registry adapters. Keeping this cohesive core in one library avoids additional packages and dependency cycles.

Depending on the library starts no threads and performs no input, UI, registry, file or network operations. The host supplies ActionClock and ActionInput; perform_press releases after an accepted press even when cancelled. Adapters must retain failed releases for retry (InputOwner provides this bookkeeping) and must not release input owned by someone else. The core is platform-independent; the application supports Windows 10+ x64. No minimum Rust version is declared.

For example, after unpacking a cargo package --offline archive, an independent project can depend on that package without copying its implementation:

[dependencies]
trayclick = { path = "../unpacked/trayclick-1.0.1" }

use std::time::{Duration, Instant};
use trayclick::ActionRun;

let started = Instant::now();
let run = ActionRun {
    id: 1,
    started,
    deadline: Some(started + Duration::from_secs(1)),
};
assert!(run.expired(started + Duration::from_secs(1)));

The package includes the original TrayClick source by Sean Shaffer and its MIT license. Preserve the copyright and license when reusing it. Run cargo test --lib --offline for core tests; host adapters need their own integration tests.

License

MIT — see LICENSE.