Skip to content

mmmelson/SnapClick

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SnapClick

SnapClick Logo

The easiest and most handy auto-clicker for Mac

macOS Architecture License

English | 中文

Download

Click Download to start!

SnapClick is too intuitive; you won't need any introduction.

SnapClick Screenshot

First Time Setup

When you first open SnapClick, macOS will show a security dialog since it's not from the App Store. Follow these steps:

Security Dialog Step 1 Security Dialog Step 2
  1. Click "Done" when the first dialog appears (don't move to trash!)
  2. Go to System SettingsPrivacy & Security
  3. Scroll down and click "Open Anyway"
  4. SnapClick will now launch successfully

Why SnapClick?

I recently stumbled upon the browser version of Command & Conquer: Red Alert 2 and discovered it runs on Mac! Triggered a wave of childhood nostalgia, I quickly found myself addicted to my first "gaming enlightenment" all over again.

However, building a tank army demands rapid, repetitive clicking - especially challenging when using just a trackpad! 😅 I tried several off-the-shelf auto-clickers, but they were either locked behind a paywall or just didn't feel right.

That's why I built SnapClick — a simple, stable auto-clicker that just works.

Features

  • 🎯 Multiple Schemes - Different click configs with custom hotkeys
  • Global Hotkeys - Trigger from anywhere
  • 🖱️ Left & Right Click - Both buttons supported
  • ⏱️ Precise Control - Set exact counts and duration
  • 📊 Background Running - Works even when window is closed

FAQ

What are the system requirements?
  • macOS: 13.0 (Ventura) or later
  • CPU: Apple Silicon (M1/M2/M3/M4)
  • Permissions: Accessibility access (required for global hotkeys and mouse control)
Can't open the app?

macOS will show a security warning because this app is not notarized. This is normal for open-source apps without Apple Developer membership.

Option 1: Right-click to open (Recommended)

Right-click the app → OpenOpen (required once for unsigned apps)

Option 2: System Settings

Go to System SettingsPrivacy & Security → Click Open Anyway

Option 3: Terminal

xattr -cr /Applications/SnapClick.app
open /Applications/SnapClick.app
How do I grant Accessibility permission?

Go to System SettingsPrivacy & SecurityAccessibility → Enable SnapClick

If already enabled but not working, try toggling it OFF then ON again.

What's the CPS limit?

⚠️ Maximum: 200 CPS (Clicks Per Second)

Higher speeds can crash macOS. The app prevents unsafe configurations.

Formula: CPS = Clicks ÷ Duration

Examples:

  • ✅ 100 clicks in 1 sec = 100 CPS (Safe)
  • ❌ 100 clicks in 0.3 sec = 333 CPS (Blocked)
Hotkeys not working?
  1. Check Accessibility permission is granted
  2. Verify scheme is enabled (green ✅)
  3. Check for conflicting shortcuts
  4. Restart the app
Intel Mac support?

Currently Apple Silicon only. Build from source to customize target architecture.

How to build from source?
git clone https://github.com/mmmelson/SnapClick.git
cd SnapClick
./Scripts/build_app.sh

Changelog

v3.1 - 2026-01-05 (Latest)

  • 🐛 Fixed critical bug: Schemes no longer execute multiple times after app restart
  • Hotkey conflict detection: App now prevents duplicate hotkeys and shows clear warnings
  • 🎁 Default schemes: First-time users get two preset schemes (Left Click ⌥1, Right Click ⌥2)
  • 🧹 Code cleanup: Removed debug logging for better performance
  • 🏗️ Architecture improvement: Single ViewModel instance using @EnvironmentObject

v3.0 - 2025-12-28

  • 🎨 Redesigned scheme card interaction: entire card clickable for editing
  • 🎯 Moved toggle to right side with proper vertical centering
  • 🏷️ Added "Hotkey" label in scheme preview cards
  • ➕ Added "Add" label to new scheme button with icon
  • 🔤 Improved font consistency across all UI elements
  • 🐛 Fixed text overflow issues in scheme preview cards
  • 🐛 Fixed scheme editor title display issue
  • ✨ Enhanced layout spacing and padding throughout

v2.0 - 2024-12-26

  • 🐛 Fixed click count accumulation bug when updating schemes
  • 🐛 Fixed app crash on hotkey trigger
  • ✨ Enhanced global hotkey reliability across all apps
  • 📦 Added custom DMG installer with visual guide

v1.0 - 2024-12-25

  • 🎉 Initial release

License

MIT License - see LICENSE


Enjoy using SnapClick! 🎉

If you find it useful, please give it a ⭐️ Star

Report Issue · Request Feature

About

The easiest auto-clicker for macOS | Mac上最易用的鼠标连点器

Topics

Resources

License

Stars

Watchers

Forks