HotkeyClash icon

HotkeyClash

HotkeyClash 是一款 macOS 工具,可掃描執行中的 App、Karabiner、skhd 與系統快捷鍵,找出鍵盤快捷鍵衝突,協助你判斷哪個 App 佔用該快捷鍵,以及應該在哪裡修改。

HotkeyClash

概覽

HotkeyClash 是一款 macOS 工具,用來找出鍵盤快捷鍵在執行中 App、自動化工具與內建系統快捷鍵之間的衝突。它會掃描來自即時 App 的選單列快捷鍵、讀取 Karabiner-Elements 與 skhd 設定檔,並檢查 macOS 的符號熱鍵,讓你一次看見所有被佔用的按鍵組合。

這個 App 主要針對在同一台 Mac 上同時使用多個快捷鍵密集工具的人,幫助你在某個組合失效時找出是哪個 App 擁有它。它會區分明確衝突與依焦點而定的重疊,然後顯示佔用者與來源,讓你不必猜測就能改對設定。

功能

即時掃描執行中 App

透過 Accessibility API 掃描每個執行中應用程式公開的快捷鍵,讓你看到 macOS 實際呈現的選單快捷鍵。

解析自動化設定

直接讀取 `karabiner.json` 和 `skhdrc`,即使那些重新對應或由設定定義的熱鍵從未傳到其他 App,也會被納入。

包含系統快捷鍵

納入 macOS 符號熱鍵,包括 Mission Control、Spotlight、螢幕截圖與 Dock 隱藏等內建快捷鍵。

衝突嚴重性分類

依鍵盤組合彙整所有綁定,並標示明確與潛在衝突,幫助你分辨真正的衝突與依焦點而定的重疊。

清楚來源標示的可讀 Mac 介面

提供原生的分割視圖介面,搭配來源標籤、App 圖示,以及會計算明確衝突數量的選單列徽章。

隱私優先的本機運作

維持輕量且可檢視,沒有網路請求、沒有帳號、沒有遙測,也不會在結束後保留掃描結果。

使用情境

  • 排查全域熱鍵衝突

    在你手動除錯之前,先確認啟動器、視窗管理器或快捷鍵工具是否正佔用了另一個全域熱鍵相同的按鍵組合。

  • 診斷依焦點而定的快捷鍵衝突

    比較 App 的選單快捷鍵與系統層級綁定,了解為什麼某個指令只會在該 App 開啟且取得焦點時失敗。

  • 稽核快捷鍵密集的自動化設定

    將 Karabiner-Elements 與 skhd 規則和 App 快捷鍵一併檢視,讓重新對應的按鍵與 shell 驅動的綁定都納入同一份清單。

  • 在指派前先檢查快捷鍵

    在 System Settings 或 App 偏好設定中指定新快捷鍵前先確認,尤其當你已經執行多個會註冊全域熱鍵的工具時。

  • 為忙碌的 Mac 建立快捷鍵地圖

    當你整理一台同時混用內建快捷鍵與第三方 App 的繁忙 Mac 時,可把掃描結果當作權威清單來使用。

Pros and Cons

Pros

  • 一次掃描執行中 App、Karabiner、skhd 與 macOS 系統快捷鍵。
  • 將明確衝突與潛在衝突分開,讓結果列表更容易採取行動。
  • 提供來源標籤與佔用細節,協助你判斷應該在哪裡修改。
  • 本機執行,沒有網路請求、沒有帳號、也沒有遙測。
  • 依 GPL-2.0 授權免費且開源,程式碼可供檢視。

Cons

  • 它不會編輯或重新指派快捷鍵;要修正衝突仍需在受影響的 App 或「系統設定」中處理。
  • 涵蓋範圍限於網站列出的掃描器與解析器,雖然路線圖中提到還會加入更多解析器。

FAQ

HotkeyClash 需要輔助使用權限嗎?

HotkeyClash 會在第一次掃描時要求「輔助使用」權限,以便讀取執行中 App 的選單快捷鍵。即使沒有這項權限,它仍可掃描 Karabiner、skhd 與 macOS 系統快捷鍵,但在取得授權前無法檢查執行中 App 的選單。

HotkeyClash 會掃描哪些來源?

它會一次掃描執行中 App 的選單快捷鍵、Karabiner-Elements 規則、skhd 熱鍵,以及 macOS 系統快捷鍵。功能頁也說明,路線圖中還包含更多解析器,例如 Keyboard Maestro、BetterTouchTool、Hammerspoon、Alfred 和 Raycast。

HotkeyClash 如何分類衝突?

這個 App 會標示明確衝突與潛在衝突。明確衝突是指兩個全域熱鍵使用相同組合;潛在衝突則是全域熱鍵與 App 的選單快捷鍵重疊,且只有在該 App 取得焦點時才會失效。

HotkeyClash 可以幫我修正快捷鍵嗎?

HotkeyClash 不會編輯或重新指派快捷鍵。掃描顯示衝突後,你需要在相關 App 或「系統設定」中修改快捷鍵,然後再次掃描以確認衝突已排除。

支援哪些平台與安裝方式?

HotkeyClash 是一款用來找出快捷鍵衝突的 macOS 工具,可透過 DMG 下載或 Homebrew 安裝。網站說明它支援 macOS 14+,包含 Apple Silicon 與 Intel Mac,並且依 GPL-2.0 授權免費且開源。

Quick Facts

Category
Developer Tool
Platform
macOS 14+; Apple Silicon and Intel
License
GPL-2.0
Pricing
Free forever
Primary task
Find keyboard shortcut conflicts
Install options
DMG download or Homebrew cask