Clakr

Click that, Clakr that!

Clakr is an auto-clicker application developed in Swift, focusing on high-speed automated mouse clicking.

---

Note

The website used for validation is my auto clicker validator. You can view the source code here.

For a higher quality demonstration, you can download the MP4 video. Please note that GitHub does not natively display MP4 files, so you will need to download and view it locally.

Caution

Please be aware that by using Clakr, you accept full responsibility for any consequences, such as bans or penalties from software or services that prohibit the use of auto-clickers.

Table of Contents

• Features
• Quick Start
• Installation
• Performance Insights
• Development or Self-Compiling
• Troubleshooting Guide
• Contributing
• Support
• License
• Acknowledgments
• FAQs

Features

• Custom Click Rates: Define your clicks per second.
• Start Delay: Plan when the clicking begins.
• Auto-Stop Function: Automate the end of your clicking session.
• Motion Detection: Only clicks when the mouse is stationary.

Quick Start

Requirements

• macOS version 12.0 or newer.

Note

Clakr may look different compared to the picture above on macOS 12, the picture is from 14.2

Installation Steps

You can install Clakr using Homebrew or by downloading it directly from the GitHub releases page.

Installing via Homebrew

To install Clakr using Homebrew, run the following command in your terminal:

brew install --cask --no-quarantine SenpaiHunters/clakr/clakr

• It's important to note that passing --no-quarantine with brew ensures macOS Gatekeeper is disabled, allowing the app to open even if it's unsigned.

Tip

The Homebrew cask for Clakr are maintained in a separate repository, which is open-sourced and available here.

Installing from GitHub Releases

Alternatively, you can manually install Clakr by downloading the latest release:

1. Download the latest release from the Releases page.
2. Move the downloaded application to your Applications folder.
3. If macOS prompts you about an unsigned application, right-click on Clakr and choose "Open" to proceed with the installation.

This method allows you to bypass macOS's gatekeeper checks for unsigned applications on the first run.

Tip

Want to skip needing to reconfirm each update? Run xattr -d com.apple.quarantine clakr.app, this will disable quarantine, i.e., Gatekeeper for the app.

Performance Insights

This has been moved to Performance.md. For the results, check there!

Development or Self-Compiling

Instructions

Before You Begin

Skip this section if you already have an Apple Developer account.

0. Enroll your account in the Developer Program at developer.apple.com. A free account works just fine; you don't need a paid one.
1. Install Xcode.
2. Add your Developer account to Xcode. To do this, click Xcode → Preferences in the Menu bar, and in the window that opens, click Accounts. You can add your account there.
3. After adding your account, it will appear in the list of Apple IDs on the left side of the screen. Select your account.
4. At the bottom of the screen, click Manage Certificates....
5. On the bottom left, click the + icon and select Apple Development.
6. When a new item labeled Apple Development Certificates appears in the list, press Done to close the account manager.

Compiling Clakr

1. Clone this repository using git clone https://github.com/SenpaiHunters/Clakr.git && cd Clakr && open Clakr.xcodeproj. Xcode will open the project.
2. Wait until all dependencies are resolved. This should take a couple of minutes at most.
3. In the file browser on the left, click Clakr at the very top. It's the icon with the App Store logo.
4. In the pane that opens on the right, click Signing & Capabilities at the top.
5. Under Signing, change the Team dropdown to None.
6. Under Signing → macOS, change the Signing Certificate to Sign to Run Locally.
7. In the Menu Bar, click Product → Archive and wait for the build to finish.
8. A new window will open. From the list of Clakr entries, select the topmost one, and click Distribute App.
9. In the popup that appears, click Custom, then click Next in the bottom right of the popup.
10. Click Copy App.
11. Open the resulting folder. You'll see an app named Clakr. Drag Clakr to your /Applications/ folder, and you're all set!

Troubleshooting Guide

If you encounter issues while using Clakr, here are some common problems and their solutions:

• Application won't start: Ensure that you have the required macOS version and that you have followed the installation steps correctly. If the issue persists, try restarting your computer. If the problem continues, please submit an issue on our Issues page.

• Clicks are not registering: Check if Clakr has the accessibility permissions in your system settings and ensure that no other software is interfering with its operation.

If you encounter further issues, please submit an issue on our Issues page.

Contributing

We welcome contributions! Feel free to submit pull requests or create issues for any bugs or enhancements.

Support

If you need help or want to discuss Clakr, check out our Issues page.

License

This project is licensed under the GNU GPLv3 license. See the LICENSE file for more details.

Acknowledgments

• KawaiiFumiko002

  • App icon creator

• Sindre Sorhus

  • Keyboard Shortcuts

• Sparkle

Explore More

• Autoclicking Test Site
• Validator Source Code

Frequently Asked Questions (FAQs)

Click to Expand

• Q: Can I use Clakr for gaming?

  • A: Yes, but you should check the game's terms of service regarding the use of auto-clickers. Clakr will not be held responsible for any consequences, such as bans or penalties, from software or services that prohibit the use of auto-clickers.

• Q: Does Clakr work on non-macOS systems?

  • A: Currently, Clakr is only available for macOS version 12.0 or newer.

• Q: How can I contribute to the development of Clakr?

  • A: Check out our Contributing section for guidelines on how to contribute.

• Q: How much system resources does Clakr use?

  • A: Clakr uses about 38.7 MB of RAM when open, and depending on the clicks per second (CPS) you set, it consumes approximately 0.7% of your CPU while active (values measured using btop).

• Q: Is Clakr a menu bar app?

  • A: Yes, Clakr can be configured as a menu bar app or used as a standalone application, whichever you prefer. This option can be found in the settings.

• Q: Does Clakr support hotkeys?

  • A: Yes, hotkey activation for Clakr is supported!

• Q: Do you plan on supporting any lower macOS versions?

  • A: No, macOS 12 is the minimum version we plan to support. Building Clakr for lower versions may be possible, but it is untested and not officially supported.

• Q: Is Clakr available through Homebrew?

  • A: Yes! It can be installed by running brew install --cask --no-quarantine SenpaiHunters/clakr/clakr.

• Q: Am I going to change the name to Clark?

  • A: Who knows! Maybe, even I don't know!

• Q: Does Clakr track me?

  • A: Clakr does not track your activities. In version 1.1 (481), we introduced auto-updating, which pings senpaihunters.github.io, our update domain. If you're concerned about privacy, you can block this domain using tools like LuLu or Little Snitch, or by adjusting your DNS settings. However, blocking the domain means you'll need to manually check for and install future updates. Alternatively, you can disable auto-updating in the app's settings, which will prevent the app from making update requests, offering a similar outcome to using a network blocking tool. As always, you are welcome to inspect our code.

---

© 2024 Clakr GNU General Public License v3.0.