Skip to content

ikanam/BetterClicker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BetterClicker

简体中文

BetterClicker is a lightweight macOS menu bar utility that maps keyboard shortcuts to click positions inside specific apps. It is built for repetitive desktop workflows where a hotkey is faster than finding the same button over and over again.

BetterClicker main window

Highlights

  • Create separate profiles for different apps.
  • Add shortcut-to-click mappings with optional notes.
  • Record positions visually, then replay them with a keyboard shortcut.
  • Choose between Edge Offset and Proportional coordinate modes.
  • Enable or pause the service directly from the menu bar.
  • Optionally launch BetterClicker at login.
  • Keep everything local with no external service dependency.

How It Works

  1. Add an app profile from the running apps list or choose an app manually from /Applications.
  2. Create a mapping and record a shortcut for the action you want to automate.
  3. Pick a coordinate mode:
    • Edge Offset: stores the click position as a fixed distance from a selected window corner.
    • Proportional: stores the click position as a normalized value that scales with the window size.
  4. Click Save & Record Position, then click the target control inside the app window.
  5. When that app is frontmost, press the shortcut and BetterClicker will replay the click for you.

BetterClicker mapping editor

Requirements

  • macOS 14.0 or later
  • Accessibility permission, which is required for shortcut detection and synthetic clicks
  • Login Items approval if you enable launch at login on macOS

Build And Run

  1. Open BetterClicker.xcodeproj in Xcode.
  2. Select the BetterClicker target.
  3. Build and run the app on macOS.
  4. Grant Accessibility permission when prompted.

Tech Stack

  • SwiftUI
  • SwiftData
  • AppKit / ApplicationServices for system integration

Privacy

BetterClicker stores app profiles and mappings locally on your Mac. The current codebase does not depend on any backend, analytics service, or third-party package.

License

This project is released under the MIT License.

Contributing

Issues and pull requests are welcome if you want to improve the app, refine the UI, or help expand the automation workflow.

About

A lightweight macOS menu bar utility that maps keyboard shortcuts to click positions inside specific apps.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages