Complete macOS Setup Guide for ClickMate

System Requirements

Before installing, ensure your Mac meets these requirements:

• macOS Version: macOS 11 (Big Sur) or later
• Processor: Intel or Apple Silicon (M1/M2/M3)
• Storage: 50MB free space
• Permissions: Administrator access for initial setup

Step 1: Download ClickMate

1. Visit the official ClickMate website or GitHub releases page
2. Download the .dmg file for macOS
3. The file will be saved to your Downloads folder

Step 2: Install the Application

1. Double-click the downloaded .dmg file
2. A new window will open with the ClickMate icon
3. Drag the ClickMate icon to the Applications folder
4. Eject the DMG by right-clicking and selecting "Eject"

Step 3: Handle "App is Damaged" Error

When you first try to open ClickMate, macOS may show an error saying the app is "damaged" or "can't be opened." This is because the app is not notarized by Apple. Here's how to fix it:

Method 1: Using Terminal (Recommended)

Open Terminal (found in Applications → Utilities) and run:

cd /Applications && xattr -cr ClickMate.app && open ClickMate.app

This command removes the quarantine attribute that macOS applies to downloaded apps.

Method 2: Using System Settings

1. Try to open ClickMate (it will fail)
2. Go to System Settings → Privacy & Security
3. Scroll down to find the message about ClickMate being blocked
4. Click "Open Anyway"
5. Confirm by clicking "Open" in the dialog

Step 4: Grant Accessibility Permissions

For ClickMate to control mouse clicks, it needs Accessibility permissions:

1. Open System Settings
2. Navigate to Privacy & Security → Accessibility
3. Click the lock icon and enter your password
4. Click the + button
5. Navigate to Applications and select ClickMate
6. Ensure the toggle next to ClickMate is ON

Step 5: Configure Global Hotkeys (Optional)

For the global hotkey feature to work reliably on macOS:

1. Go to System Settings → Privacy & Security → Input Monitoring
2. Add ClickMate to the list and enable it
3. This allows ClickMate to detect keyboard shortcuts even when it's not the active window

Troubleshooting Common Issues

Issue: Clicks Not Working

Solution: Check Accessibility permissions. Even if you've granted them before, sometimes macOS resets them after updates. Re-add ClickMate to the Accessibility list.

Issue: Hotkey Not Responding

Solution: Ensure Input Monitoring permission is granted. Also check if another app is using the same hotkey.

Issue: App Crashes on Startup

Solution: Try the following:

1. Delete ClickMate from Applications
2. Re-download the latest version
3. Run the xattr -cr command again
4. Reinstall and re-grant permissions

Issue: "App is from unidentified developer"

Solution: Right-click on the app, select "Open", then click "Open" in the dialog. This bypasses Gatekeeper for this specific app.

Apple Silicon (M1/M2/M3) Considerations

ClickMate runs natively on Apple Silicon Macs. There's no need to enable Rosetta translation. If you're experiencing issues:

• Ensure you downloaded the correct version
• Check Activity Monitor to confirm it's running as "Apple" not "Intel"
• Some very old versions might require Rosetta - update to the latest version

Best Practices for macOS

• 🔄 Keep Updated - Always use the latest version for best compatibility
• 🔐 Security First - Only download from official sources
• ⚡ Grant Minimal Permissions - Only enable what's needed
• 📊 Monitor Resources - Check Activity Monitor if you notice slowdowns