stars/HotkeyClash
2
0
Fork 0
mirror of https://github.com/Wunderlandmedia/HotkeyClash.git synced 2026-06-23 00:33:19 -06:00
Code Issues Projects Releases Packages Wiki Activity
Find where your keyboard shortcuts clash. A free, open-source macOS menu bar app that detects shortcut conflicts across apps, config tools, and system settings. — ⭐ 39 https://hotkeyclash.com
14 commits 1 branch 1 tag 860 KiB
  • Swift 88%
  • Shell 12%
Find a file
Exact
Wunderlandmedia 9a814d662e docs: Update Homebrew installation instructions and add upgrade command 
feat: Enhance publish-release script to update Homebrew tap cask with new version and sha256
2026-06-19 08:32:35 +02:00
.github Add funding config and security policy 2026-06-16 12:12:16 +03:00
HotkeyClash feat: Add unit tests for AccessibilityService and conflict classification 2026-06-16 11:48:56 +03:00
HotkeyClash.xcodeproj feat: Add unit tests for AccessibilityService and conflict classification 2026-06-16 11:48:56 +03:00
HotkeyClashTests feat: Add unit tests for AccessibilityService and conflict classification 2026-06-16 11:48:56 +03:00
scripts docs: Update Homebrew installation instructions and add upgrade command 2026-06-19 08:32:35 +02:00
.gitignore first commit 2026-06-14 18:25:20 +03:00
CONTRIBUTING.md refactor: Update CI workflow to run tests instead of build and document test execution 2026-06-16 11:51:00 +03:00
LICENSE first commit 2026-06-14 18:25:20 +03:00
README.md docs: Update Homebrew installation instructions and add upgrade command 2026-06-19 08:32:35 +02:00
SECURITY.md Add funding config and security policy 2026-06-16 12:12:16 +03:00

README.md

HotkeyClash

Find where your keyboard shortcuts clash.

macOS 14+ Swift 6.2 GPL-2.0 Zero dependencies

Open-source macOS menu bar utility that scans running apps, config files, and system shortcuts to detect keyboard shortcut conflicts. Master-detail split view shows every clash at a glance.

Features

  • Scans running apps' menu bar shortcuts via Accessibility API
  • Parses Karabiner-Elements and skhd config files
  • Reads macOS system shortcuts (Spotlight, Mission Control, Screenshots, etc.)
  • Classifies conflicts as definite (global vs global) or potential (menu vs menu)
  • 720x520 split view: conflict sidebar + detail pane with app icons and source badges
  • Zero external dependencies. Pure Apple frameworks.

Install

Homebrew

brew install --cask wunderlandmedia/tap/hotkeyclash

To update later: brew upgrade --cask hotkeyclash.

Download

Grab the latest DMG or ZIP from Releases.

Build from source

git clone https://github.com/Wunderlandmedia/HotkeyClash.git
cd HotkeyClash
xcodebuild -scheme HotkeyClash -configuration Release build

Requires Xcode 16+ and macOS 14+.

Build a release (DMG + ZIP)

# Local build (skip notarization)
./scripts/build-release.sh --skip-notarize

# Full notarized release (after one-time Keychain setup)
./scripts/build-release.sh

Artifacts land in build/release/.

What it scans

Source Method
Running apps Accessibility API (AXMenuBar traversal)
Karabiner-Elements ~/.config/karabiner/karabiner.json
skhd ~/.config/skhd/skhdrc
macOS system shortcuts com.apple.symbolichotkeys plist

Accessibility permission is required to scan running apps. Config files and system shortcuts work without it.

Planned

  • Keyboard Maestro, BetterTouchTool, Hammerspoon, Alfred, Raycast parsers
  • Real-time "test this shortcut" mode (press a combo, see which app catches it)
  • Export conflict report as Markdown
  • Auto-rescan on app launch/quit

Also by Wunderlandmedia

  • QuietClip -- Privacy-first clipboard manager for macOS
  • WunderType -- AI text correction via keyboard shortcuts

Contributing

Issues and pull requests welcome. Each config file parser is a self-contained method in ConfigFileScanner.swift, making it straightforward to add support for new tools.

License

GPL-2.0