Skip to content

inigoromano/AutoClicker-macOS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AutoClicker macOS

AutoClicker is a native SwiftUI utility for macOS that repeatedly posts left or right mouse clicks at either the current pointer location or a saved fixed screen position.

It is intended as a small personal automation tool. Use it responsibly and follow the rules of any app, game, or service where you enable automated clicking.

Features

  • Current-pointer and fixed-position click modes
  • Left-click and right-click support
  • Interval mode from 1 ms to 60,000 ms
  • Clicks-per-second mode up to 1,000 CPS
  • Unlimited runs or fixed click counts up to 9,999,999
  • Configurable global start/stop shortcut, defaulting to Control-Option-C
  • Multi-display fixed-position picker
  • Menu bar controls for status, start/stop, opening the window, and quitting
  • Persistent settings with UserDefaults
  • Automatic stopping on sleep, session lock, logout, permission loss, or invalid fixed display coordinates

Requirements

  • macOS 14 Sonoma or newer
  • Accessibility permission for click automation
  • Xcode 26 or newer for development

Download And Run

The repository includes a local personal-use build in outputs/.

  1. Open outputs/AutoClicker.app, or unzip outputs/AutoClicker.zip and open the app bundle inside it.
  2. In AutoClicker, select Request Access or Open Settings.
  3. Enable AutoClicker in System Settings -> Privacy & Security -> Accessibility.
  4. Return to AutoClicker. The permission status refreshes automatically.
  5. Configure the click target, speed, mouse button, and run limit.
  6. Select Start Clicking, or press Control-Option-C.

High click rates are best effort. macOS and target applications may coalesce, throttle, or drop mouse events, especially near 1 ms / 1,000 CPS.

Accessibility Troubleshooting

This build is ad-hoc signed for local use. Rebuilding or replacing AutoClicker.app changes the app's macOS security identity, even when the bundle identifier is the same.

If AutoClicker still says Accessibility access is required after you enabled it:

  1. Quit AutoClicker.
  2. Open System Settings -> Privacy & Security -> Accessibility.
  3. Remove old AutoClicker entries.
  4. Add the exact current AutoClicker.app you are running.
  5. Enable it, then relaunch AutoClicker.

Development

Open AutoClicker.xcodeproj in Xcode and run the AutoClicker scheme.

Build from the command line:

xcodebuild \
  -project AutoClicker.xcodeproj \
  -scheme AutoClicker \
  -configuration Debug \
  -derivedDataPath work/DerivedData \
  CODE_SIGNING_ALLOWED=NO \
  build

Run tests:

xcodebuild \
  -project AutoClicker.xcodeproj \
  -scheme AutoClicker \
  -derivedDataPath work/DerivedData \
  test

Safety And Use

AutoClicker posts real mouse events through macOS Accessibility APIs. Before using it in another app, confirm that automation is allowed there. You are responsible for any effects caused by automated clicking.

Feedback

Have a bug report, feature request, or idea? Share it on the AutoClicker feedback board:

macOS AutoClicker Feedback

License

AutoClicker is released under the MIT License.

About

Native macOS AutoClicker built with SwiftUI, menu bar controls, global hotkeys, and Accessibility-based click automation.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages