othyn / macos-auto-clicker

A simple auto clicker for macOS Big Sur, Monterey, Ventura and Sonoma.

Auto Clicker for macOS

A simple auto clicker for macOS Big Sur (11), Monterey (12), Ventura (13) and Sonoma (14) built with ♥️ in Swift & SwiftUI.

Download Latest Version · Report a Bug · Request a Feature

📔 Table of Contents

• About the Project
  • Screenshots
  • Tech Stack
  • Features
• Download
  • Preferences Storage
• Contributing
• Roadmap
• Changelog
• License
• Acknowledgements

🌟 About the Project

All the auto clickers out there were either really outdated, old, buggy and/or have legacy code bases. This one aims to fix all that giving you flexibility and style. Plus, I get to write in easter eggs, who says love can't be colourful.

📷 Screenshots

👾 Tech Stack

• Swift
• Swift UI
• Package: sindresorhus/KeyboardShortcuts
• Package: sindresorhus/Defaults
• Package: othyn/DateStrings

🎯 Features

• An auto clicker of mouse buttons and presser of keyboard keys!
• Allows for pressing or clicking;
  • ... of any mouse or keyboard button
  • ... at a given interval
  • ... for a given amount of presses per interval
  • ... for a given amount of times
  • ... after a delayed start
• Custom keyboard shortcuts to start and stop the clicking or pressing globally
• Option to keep the window on top for easy access
• Persists all your options between sessions
• Fresh and modern UI/UX
• Lots of colour schemes to suit what ever you prefer

💾 Download

Download for macOS Ventura (13), Sonoma (14) and higher: v1.7.21

Download for macOS Big Sur (11) or Monterey (12): v1.6.1

When first using the app, you will need to right click the app and click 'Open', then on the macOS popup window select 'Open' again to trust this version of the app going forward. This is as at the moment I don't have a paid Apple developer account in order to notarize the app.

When updating the app, does the permission screen get stuck even though you've given it permission? There can sometimes be an issue with this, I'm not entirely sure why this occurs, as the bundle identifier for the app remains the same and therefor the granted permissions shouldn't either. MacOS gets 'stuck' thinking the app has permissions when it doesn't and so the permission splash screen for the app will never go away. To fix it, click the minus button at the bottom of the list of apps under macOS's Accessibility settings where Auto Clicker is listed to manually remove Auto Clicker from the list of permitted apps. Close Auto Clicker and re-open it and grant it access once again, which should fix the issue. More detail can be found in the thread for Issue #64.

For more downloads, checkout the releases page for app downloads of any version you want to use, even pre-release builds too.

⚙️ Preferences Storage

The configuration for the app is stored using NSUserDefaults, via the sindresorhus/Defaults package, meaning all the applications preferences are stored in the following location:

~/Library/Preferences/com.othyn.auto-clicker.plist

This file can be backed up and/or be used transfer your preferences to other machines, although I'll leave the mechanism for doing so up to you.

If you are looking for ideas on how to achieve this, I often like to use Symbolic Links (symlink). By placing the real version of the file in the backup location (in something like a git repo, cloud storage or local/remote storage) and then creating a symlink to the location that the application is expecting, you can safely store the file in the backup location without having to manually move it around or setup auto copy tasks. I accept no responsibility for using this approach, this is for education purposes only, do this at your own risk.

The following commands are an example of how you can achieve this, making sure to close the app first before doing this to avoid any issues:

# Firstly, move the preferences file to the backup location
mv "${HOME}/Library/Preferences/com.othyn.auto-clicker.plist" /path/to/backup/directory/com.othyn.auto-clicker.plist

# Secondly, create a symlink from our backup location to the expected file location for the app
ln -s /path/to/backup/directory/com.othyn.auto-clicker.plist "${HOME}/Library/Preferences/com.othyn.auto-clicker.plist"

Note that both paths used must be the absolute path to the file, any relative paths won't resolve and the symlink will be created but silently fail as it will be pointed at a path that cannot resolve to the target.

🐭 Contributing

See the contribution guide on how to get started. Thank you for contributing!

Detailed within that guide are steps on how...

• ... issues should be used.
• ... to setup the project.
• ... to contribute new languages via the app's localisation support.
• ... branches should be used.
• ... commits should be formatted.
• ... pull requests should be submitted.
• ... the build process works and the automation that drives it.

This gold star ⭐ can be yours if you can figure out why the emoji is a mouse.

⚠️ License

Distributed under the MIT License. See LICENSE for more information.

💎 Acknowledgements

Useful resources and libraries that have been used in the making of this project.

• Readme: shields.io
• Readme: ikatyang/emoji-cheat-sheet
• Readme: Louis3797/awesome-readme-template
• Package: sindresorhus/KeyboardShortcuts
• Package: sindresorhus/Defaults
• Package: othyn/DateStrings

---

Why a mouse emoji? Auto Clicker > Click with a mouse > Mouse! ... yeah, I know... I know...

macos-auto-clicker's Issues

Great helper app, why can't you find it in the mac app store?

Description

Can you submit it to the mac app store? It makes downloading easier.

Desired Behavior

Thanks!

Additional Context

No response

Cursor Jump Bug on Secondary Monitor in Auto Click Program

Description

I've encountered a persistent bug in the auto click program starting from version 1.5.0 up to the latest version I installed, 1.7.21 (5a1b91e). When the program is initiated, and the cursor is located on a secondary monitor, which is positioned directly above the primary monitor, each click results in a noticeable jump along the y-axis.

Version

1.7.21 (5a1b91e)

Steps to Reproduce

1. Start the auto click program on a MacBook Pro with the described monitor setup.
2. Position the cursor on the secondary monitor.
3. Initiate a click action.

Expected Behavior

The cursor should remain stationary upon clicking, without any jumps or shifts in position.

Actual Behavior

The cursor makes a visible jump along the y-axis with each click when on the secondary monitor.

Screenshots

No response

Device

Apple MacBook Pro with M1 Pro chip

Operating System

macOS Sonoma 14.4.1

Additional Context

• Primary Monitor Resolution: 3456x2234 pixels
• Secondary Monitor Resolution: 1920x1080 pixels
• Connection: USB-C

As a user, I would like to be notified of a new release/update and download it

Not sure how other devs do this, or manage auto update handling, but it would be cool at least to just check if a new release is available. Maybe check for N+1 on the release patch version? Or any major/minor version for that matter, the UI could respond to that and say as such depending on what the latest build version is in comparision to the current one.

Hold autoclick

Hold idea: when pressed, an autoclicker occurs, not pressing and then pressing to turn it off, but holding

As a user, I want to be able to create multiple sequences of action stages

Very far off and blue sky thinking, but I think it would be cool to allow for multiple action stages to be created and then ordered.

So the UI/UX would be a draggable text interface, something like:

---

Action Stages

= Every <duration field> press <input field> <amount of actions field> times and wait <duration field> before doing it again for a total of <amount of iterations field> times.

= Every <duration field> press <input field> <amount of actions field> times and wait <duration field> before doing it again for a total of <amount of iterations field> times.

---

In which the user could re-arrange the sequence based on their preferred order of execution.

Taking this further, you could even do conditional logic, but I'm not sure what conditions would be useful or if the feature would be at all.

As a user, I want the UX/UI to be more intuitive to understand

As part of this, I'd love to have a re-factor of the UI to make this easier to understand.

Perhaps in the layout of:

"Every <duration field> press <input field> <amount of actions field> times and wait <duration field> before doing it again for a total of <amount of iterations field> times."

I mentioned this as part of Issue #2 and would like to work on this now, otherwise there are going to be a load of fields with a cramped and non-intuitive UI.

Above all I want this to be easy to use and intuitive following a natural language form pattern.

---

I want this to be called/referred to as the 'Action Stage'. An action stage is a scentence describing what should occur at each interval of the timer:

"Every <duration field> press <input field> <amount of actions field> times and wait <duration field> before doing it again for a total of <amount of iterations field> times."

Random wait time range

Description

It would be great to support random wait time range, like 0.5s - 1s, since a fixed time can be easily detected as bots

Desired Behavior

support random wait time range, like 0.5s - 1s

Additional Context

No response

Project URL in About Page

Description

It would be beneficial to include this repository's URL on the about page. I had to spend an excessive amount of time searching for this page after having installed the software for a considerable period.

Furthermore, it would be advantageous to include the URL to this repository in the footer section of the main screen.

Desired Behavior

Add repository URL to about page

Additional Context

No response

App can’t be opened

I get this error when opening the app: Auto Clicker can’t be opened because Apple cannot check it for malicious software.

As a user, I would like to see variable miliseconds and changeable key to start

I love your app, and if you add this things this app would be great I think

As a user, I want to be able to customise the start and stop button shortcut keys

Fairly self explanatory, but allow for the user to customise the start and stop action shortcut key.

This should be easier after I work on Issue #2, as the logic for capturing the shortcut key should be the same.

Shortcuts

Description

Even I have changed the shortcuts of the app to start and stop, main app icon on taskbar still show cmd + F

Version

1.6.1

Steps to Reproduce

Change shortcuts in settings
Visit main menu app

Screenshots

No response

Device

MacBook Pro

Operating System

macOS Ventura 13.4.1

Additional Context

No response

As a user, I would like the application preferences stored to a file so I can back it up

At the moment I'm just using the Defaults package to store entities to user defaults, as it was easy and had native Combine support so reactivity and automatic storage to disk was handled as the defined objects were updated.

However, I love to backup preferences for applications I used to git or other such scripts via symlinks and such, it just generally makes it easier if the source of truth for applications was stores somewhere that you can backup.

This is just for me to implement that, removing the Defaults library and replacing it with an alternative that stores to disk. At the moment the simplest way would probably be JSON as you can conform the class to Codable and have some sort of PrefStoreService that handles saving things to disk in place of Defaults.
There may also be a library that handles this with Combine support for SwiftUI.

As a user, I would like the app to function without explicit security approval

For this, I'll need a dev cert from a paid dev account so I can sign the app to allow macOS of verify the signature is from a known developer

As a user, I want to be able to specify the pressed key during the action phase

Firstly, great project! Really nice job with it and well written.

This is a feature request, but I think it might be nice/useful if the user could specify what input they want repeated. Obviously right now its set to left click (which makes sense as its an auto clicker 😄 ) But it would be nice if before the user taps the [Start] button, that they could configure the input.
e.g.

1. Users presses [Configure input] (default is currently left click)
2. The app then listens to what the user presses next, e.g. right click, or even a key on the keyboard.
3. Whatever the user pressed is now the thing that will get repeated. So if I right clicked, thats the thing now that will get repeated.

The other thing (and perhaps this is a separate feature request I apologise) would be to specify how many times it should perform the input action after the interval. e.g. Perhaps the user wants to double (left) click every 3 seconds, as opposed to have it click once every 3 seconds. It might be a nice feature to be able to specify how many times it should perform the input.

Again, great job and thanks for this awesome app 👍

Builds on macOS 13 are randomly failing on all channels

Description

I've been trying to debug this all day and I'm getting no where it seems.

I'm randomly getting the following error on a macOS 13 GitHub Actions runner and locally on macOS 13.4, running v6.0.0 (which at first I thought had fixed it until another run later on revealed it hadn't):

Building the DMG failed. Error: Command failed: hdiutil detach /Volumes/AutoClicker

I'm not getting any more information out of it than that.

https://github.com/othyn/macos-auto-clicker/actions/workflows/cicd.yml

The really weird thing is there is no consistency or pattern that I can see as to whether it does it or not, it seems to be truly random from my current understanding, which is kind of evident from the mixture of succeeding and failing builds.

I've about ran out of steam on this today and I'll resume debugging with a fresh head tomorrow.

This wasn't an issue on macOS 12 using version 5.3.0, only after upgrading today to macOS 13 and v6.0.0 am I starting to have issues.

Also posted a bug report here: sindresorhus/create-dmg#83

Version

= v1.6.2

Steps to Reproduce

Unknown at this time, appears to be random

Screenshots

No response

Device

Any Mac

Operating System

macOS 13.x

Additional Context

No response

As a user, I would like to be able to keep the app on top

'Keep ontop' menu toggle option

As a user, I would like to use a global shortcut to start or stop the app

Add global shortcuts (when app is not in focus), as the shortcuts currently only work in-app. Now I have AppDelegate hooks, I should be able to re-install soffes/HotKey via SPM and get them setup, making sure to place it somewhere where it won't get garbage collected

macOS Ventura Support

As was announced during the WWDC22 keynote speech, the next release of macOS is Ventura and is to be expected later in 2022.

I haven't run Auto Clicker on macOS Ventura yet, as at the moment I don't have a spare machine to run the Ventura Beta on (and haven't had time to spin up a VM), so at this time I have no idea if the app works on Ventura as-is ~ although if you've been running it on Ventura, it would be great to have some feedback on this so please leave a comment on this thread below.

I'm happily accepting any PR's on support for Ventura if support patches are required.

The only other issue is that I will need to wait for GitHub to release a new runner for macos-13 in order to have the CI/CD flow generate builds for Big Sur, Monterey and the newly released Ventura. No doubt there will also be required upgrades and patching to get all that to work due to newer versions of packages (maybe) and Xcode also being required.

As a user, I would like the option of chosing if the app should quit when the last window is closed

As the title says!

At the moment this is implicit behaviour, but really should be a user option.

As a developer, I would like automatic use of Semver

Semver auto version bumping and build numbers (see my ios-chronoscape repo (private))

Option to allow the menu bar icon to indicate when the auto clicker is running

Description

I want to be able to double-check if the auto clicker is running at a glance. Right now I have to click the menu bar icon to check it is running.

Desired Behavior

Display a different icon (suggestions welcome) when the auto click is running. Perhaps a green play button.

This could be an option in preferences that would be defaulted to being disabled.

Additional Context

I could have a look at this over the weekend, I just want to check whether it would be accepted if I make the pull request.

Autoclick after holding button

Description

Is there any chance to make that autoclik after holding a given button and stop when relase?
Or at least to change shortcuts button?

Desired Behavior

Autoclik after holding button and stop when relase

Additional Context

No response

As a user, I would like to send a press to a specific window instead of using the active window or mouse

https://stackoverflow.com/questions/54337561/send-keypress-to-specific-window-on-mac

The window size is not persisted between application sessions

Implementing the feature in #43 has revealed that the groundwork I did for the application window size being saved hasn't worked and needs to be fixed.

As a user, I would like support for localisation

As it says on the tin, this would just be the ground work required to start accepting language support PR's as part of #10

Computer Crash

Description

If you set it to Left Click 100000000 times, good luck getting your computer to work. I had to hold the power button for 20 seconds (meaning it force shutdown the computer), and it still lagged for the first minute.

Version

1.5.0

Steps to Reproduce

Screenshots

No response

Device

Mac Mini

Operating System

macOS Ventura 13.4

Additional Context

No response

Notifications

Description

Wouldn't it be great if there was an optional feature to display a notification when the process begins and ends?

Desired Behavior

Notifications

Additional Context

No response

Random Cursor Movement by Fixed Radius

Description

The app currently has a feature request for random click timing (see issue #76). To further enhance the app's capabilities and make it more effective, it would be great if the app could also support moving the cursor by a fixed radius randomly.

This feature would reduce the chances of the app being detected as a bot, making it more useful for users who need to simulate natural cursor activity.

Desired Behavior

The app should allow users to define a fixed radius (in pixels) within which the cursor can randomly move at specified intervals. Users should be able to enable or disable this feature through the settings menu. This random movement should make the cursor activity appear more natural and reduce the risk of bot detection.

Additional Context

Related Issues

• Random Click Time

Example

For instance, if a user sets a radius of 20 pixels, the cursor should randomly move within a 20-pixel radius circle from its starting point at specified intervals. This movement should appear natural and non-linear.

Your absolutely incredible app isn't opening for me!

I tried setting the start and stop options to the same keypress, and the app quit on me and was never able to reopen again, no matter the version. Is there a fix for this, and if so, what is it?

As a developer, I would like some form of automated test suite

As a user, I would like to be informed if I don't have the necessary permissions granted to allow the app to work

For other apps, I've noticed that they have a pop-up that informs the user what to do if they don't have the permissions that the app requires granted.

In this case;

Security & Privacy > Privacy > Accessibility > ☑️ Auto Clicker.app

As a user, I would like the option to start the app at login

Basically implement this package: https://github.com/sindresorhus/LaunchAtLogin

Corrupted preferences file stops the app from being able to run

Description

Even when trying to right click and open thing, it will no longer open on the latest macos

Version

1.5.0

Steps to Reproduce

Download app
Put in applications folder
attempt to open with right click -> open

Screenshots

No response

Device

MacBook Pro

Operating System

macOS 13.3.1

Additional Context

No response

App crash when menu bar icon is disabled

Description

When I disable the "Show menu bar icon" button in the settings and run the app, the application crashes and exits after completing the clicks.

The app works fine if the "Show menu bar icon" is checked. 🤔

Version

1.7.21 (5a1b91e)

Steps to Reproduce

1. Open the app.
2. Go to Settings.
3. Disable the Show menu bar icon option.
4. Run the auto click operation.
5. Observe that the app crashes and exits after completing the auto clicks.

Screenshots

No response

Device

MacBook Pro

Operating System

macOS Sonoma 14.5

Additional Context

No response

As a user, I want to be able to specify the amount of actions performed at action phase

The other thing (and perhaps this is a separate feature request I apologise) would be to specify how many times it should perform the input action after the interval. e.g. Perhaps the user wants to double (left) click every 3 seconds, as opposed to have it click once every 3 seconds. It might be a nice feature to be able to specify how many times it should perform the input.

Break out of a sub feature request in Issue #2.

As a user I would like to be able to click every 1.5 seconds (1500 ms)

Is your feature request related to a problem? Please describe.
the largest value for milliseconds is 1000, but I would like to click every 1.5 seconds or 1500 milliseconds, which isn't possible since I can't enter a fractional second nor enter more than 1000 milliseconds.

Describe the solution you'd like
be able to enter more than 1000 milliseconds or enter fractional seconds

Describe alternatives you've considered
n/a

As a user, I would like to be able to pre-set the mouse X/Y coordinates via manually entering them AND recording them

As mentioned in #7 as part of this comment on a reference for chained actions, it would be handy for the user to be able to record or define the mouse action location ahead of time.

This should be a fairly simple addition, as it will be just capturing the location information of the mouse X/Y coord and defining a new global shortcut to trigger the capture (that can be set in preferences) although the UI/UX of it will need some work.

This would encompass doing the following:

• Mouse X/Y on mouse pressInput types should be stored and used if the user has pre-defined said input, if not it should default to the current mouse position at the time of the action being performed
  • Does this option require a checkbox or some form of sub-UI that only appears of the pressInput type is mouse on the input capture modal?
  • Pre-defined in this case would be manually editing two boxes that store the X and Y coordinates that the user can edit
• Option to record a mouse point via a shortcut key defined in the app preferences, so the user moves the mouse to the screen postion then confirms it with the keyboard shortcut and its captured by the app and stored as part of the above process
  • This would just capture the value into the boxes above as to save additional processes
  • A simple UI button called 'record mode' or something could do this, with the shortcut key displayed underneath (like the stop watch buttons) in which pressing the button activates the listener and keyboard shortcut until the shortcut is pressed, in which it stops listening at the X and Y coordinates are recorded into the editable boxes

Language Support

Firstly, I need to add Localisation support as part of #36

If anyone would like their language supported, please submit a PR!

As a user, I would like to be able to install the app via Brew

brew support

The number fields are really glitchy

Description

Its been a problem since the apps inception, but as SwiftUI doesn't have a numeric only field, you have to fudge the TextField with support which is what this app has been running on.

However, this has changed somewhat since this app was first made and there are better ways to handle updates:

https://www.hackingwithswift.com/quick-start/swiftui/how-to-format-a-textfield-for-numbers

I need to review the fields and make support better as at the moment, they're glitchy as anything. Especially when trying to change the field from something like 1 to 5 seconds as you can never remove the 1 as it won't let you empty the field.

Version

latest

Steps to Reproduce

See description.

Screenshots

No response

Device

Any Mac

Operating System

macOS 13.x

Additional Context

No response

Menu bar items rapidly appear/dissapear when waiting for permissions to be granted

Noticed this whilst testing the v1.3.0 release build, and I think its due to the way I have it setup in the application lifecycle.

Information online is really scarce on how to permanently remove menu bar items from SwiftUI apps, even when using the app delegate. Basically I had to just fiddle around with different lifecycle hooks to find something that worked, and even then its still glitchy.

Think I need to revisit the solution for this.

As a User, when running the app on macOS Ventura the UI line spacing is bugged and has no padding

As the title says.

As a user, i got a bug when press start by hotkeys twice ( option + cmd + S )

When press option + cmd + S twice program go to the infinity loop, i cant stop program by clicking on button STOP, or press option + cmd + X

Macbook air m1, OS x 13

As a developer, I would like automated CI/CD of the app builds

Simple really, as I would any project, I want automated integration and production builds of the application to take place upon each commit and tagged semver release. Continuation of #14.

This seems to be a really good and modern blog post on implementing this for mac apps, as there is so much info around for it: https://www.omerlh.info/2022/03/11/how-to-awesome-ci-cd-for-macos-apps/

As a user, I would like to be able to minimise the app to a menubar icon

Menu bar mode/move app to menu bar popup

Hold down??

Description

There are instances where I would like to not click, but hold town a mouse press or key. Is there a feature for that?

Desired Behavior

instead of clicking, I am simply holding down a key or mouse stroke

Additional Context

No response

As a developer, it would be handy to have builds automated via GitHub Actions

There are Xcode and Swift templates available on the official GitHub Actions template pages.

As a user, I want to be able to persist the applications state between sessions

Something I've done on private iOS apps in the past, but need to work out if its the same for macOS and if I can just save these values to a preference bundle or if it requires a defined data store somewhere.

But the idea here is just to persist the apps value state between sessions of the application. This including but not limited to;

• All fields for the auto clicking definitions
• Shortcuts for the start/stop buttons

no max number of clicks?

Hi there, thanks for the beautiful app. Unfortunately it doesn't quite suit my purposes since 10k clicks (1 per second) is only about 2 hours of click time. I'd like to leave auto clicking running overnight / all day.

No pressure to actually add this feature, just thought you'd like to know that I tried it out!

By the way, I found your repo by searching "macos auto clicker site:github.com" in Google.