Download

Get HotkeyClash for macOS

Free, open source, ~2 MB. No installer wizard, no account, no license key. Download, drag to Applications, scan.

macOS 14 Sonoma or later · Apple Silicon & Intel · GPL-2.0

Recommended

Direct download

  1. Grab the .dmg from the latest GitHub release
  2. Open it and drag HotkeyClash to Applications
  3. Launch it from Applications (first launch only — right-click → Open if Gatekeeper objects)

Every release ships with a SHA256SUMS.txt — verify your download with shasum -a 256 -c SHA256SUMS.txt.

Option 2

Coming soon

Homebrew

A Homebrew Cask is planned, but homebrew-cask only accepts projects above a popularity threshold — so the cask lands once the GitHub repo has enough stars.

Want it sooner? Star the repo — it directly moves the needle. Until then, the DMG is the way.

First run

Three steps to your first conflict report

Step 1

Grant Accessibility permission

On first scan, HotkeyClash asks for Accessibility access — that’s how it reads other apps’ menu shortcuts. macOS opens System Settings → Privacy & Security → Accessibility; flip the toggle for HotkeyClash. Without it, the app still scans Karabiner, skhd, and system shortcuts, just not running apps.

Step 2

Run your first scan

Click the menu bar icon (or press ⌘⇧H). The scan walks every running app, parses your config files, and reads system shortcuts — typically done in about 3 seconds.

Step 3

Read the results

Red rows are definite conflicts (two global hotkeys on one combo). Amber rows are potential conflicts (a global hotkey shadowing an app’s menu shortcut). Click any row to see every claimant and where its binding comes from.

Full setup details, including why the permission is needed and what the app can and cannot see, are in the documentation.

Sponsor the project instead of paying for it

HotkeyClash is free forever. If it saved you an afternoon of shortcut archaeology, a GitHub star or sponsorship keeps it maintained.

macOS 14+ · Apple Silicon & Intel · Free DMG download