stars/github__hunters1431__MACKey
2
0
Fork 0
mirror of https://github.com/hunters1431/MACKey.git synced 2026-06-19 01:21:12 -06:00
Code Issues Projects Releases Packages Wiki Activity
一站式 macOS 快捷键中心：速查系统快捷键、为任意程序自定义快捷键、程序坞一键启动 · All-in-one macOS keyboard-shortcut hub
28 commits 2 branches 3 tags 8.1 MiB
  • Swift 98.1%
  • Shell 1.9%
Find a file
Exact
hunter0303 527392e3b0 README 加动态演示 GIF；make_marketing 只清生成子目录(保护手作资产)
2026-06-14 17:44:43 +08:00
.github 二维码保持比例不变形 + PayPal 改 paypal.me/hunters1431 + 捐赠窗放大 2026-06-12 18:53:33 +08:00
docs v1.2.0：墨绿键帽品牌重设计 + 激活/单实例 bug 修复 + 列②拖动排序 2026-06-14 15:37:03 +08:00
marketing v1.2.0：墨绿键帽品牌重设计 + 激活/单实例 bug 修复 + 列②拖动排序 2026-06-14 15:37:03 +08:00
Resources v1.2.0：墨绿键帽品牌重设计 + 激活/单实例 bug 修复 + 列②拖动排序 2026-06-14 15:37:03 +08:00
scripts README 加动态演示 GIF；make_marketing 只清生成子目录(保护手作资产) 2026-06-14 17:44:43 +08:00
Sources/MACKey v1.2.0：墨绿键帽品牌重设计 + 激活/单实例 bug 修复 + 列②拖动排序 2026-06-14 15:37:03 +08:00
.gitignore MACKey v1.0.0: 菜单栏全局快捷键工具 2026-06-12 16:14:39 +08:00
LICENSE MACKey v1.0.0: 菜单栏全局快捷键工具 2026-06-12 16:14:39 +08:00
MACKey.entitlements App Store 适配：双版本编译条件 + entitlements 文件 2026-06-13 12:51:32 +08:00
Package.resolved MACKey v1.0.0: 菜单栏全局快捷键工具 2026-06-12 16:14:39 +08:00
Package.swift MACKey v1.0.0: 菜单栏全局快捷键工具 2026-06-12 16:14:39 +08:00
README.md README 加动态演示 GIF；make_marketing 只清生成子目录(保护手作资产) 2026-06-14 17:44:43 +08:00
README.zh.md README 加动态演示 GIF；make_marketing 只清生成子目录(保护手作资产) 2026-06-14 17:44:43 +08:00

README.md

MACKey

MACKey

Latest Release Platform License

Open any app with one key.

The macOS shortcut hub: every shortcut at a glance — look up system keys, customize any app, order them your way.

中文说明

Why MACKey

  • 🚀 Works out of the box — your first 10 Dock apps are auto-bound to ⌃1…⌃0; zero setup, instant switching
  • 🎯 Bind anything — any app × any key combo, global, one keystroke to your most-used apps
  • 🔍 See it all — system shortcuts ranked by real-world frequency, your customizations synced live; no more digging through System Settings
  • 🛡️ Never collide — live conflict detection while recording, named warnings like "taken by the system's Screenshot"
  • 🔒 Private by design — runs 100% locally; no network, no tracking, no data ever leaves your Mac

A tribute to the classic Snap. As Rosetta 2 retires, Intel apps will stop running on Apple silicon — MACKey is native ARM, picking up the baton.

Menu-bar only · Launch at login · English & Chinese · Free & open source

Screenshots

MACKey in action

MACKey runs entirely on your Mac

Install

  1. Download the latest MACKey-x.y.z.dmg from Releases.
  2. Open it and drag MACKey.app into Applications.
  3. First launch: because the app isn't notarized (no paid Apple Developer account), Gatekeeper will block it. Right-click → Open, then confirm. (Once only.)
    • Or run: xattr -dr com.apple.quarantine /Applications/MACKey.app
  4. Grant Accessibility permission (required for global hotkeys): System Settings → Privacy & Security → Accessibility → enable MACKey.

Usage

Click the ⌘K menu-bar item → "Shortcut Settings…" to open the three-column panel:

  • System Shortcuts (left): read-only reference of what's already taken.
  • App Shortcuts (middle): click + to add any app and record any combo.
  • By Dock Order (right): first 10 Dock apps are pre-bound to ⌃digit; click a field to rebind.

While recording, press a combo that includes ⌘/⌃/⌥/⇧. Esc cancels, × clears.

Note: ⌃1–⌃3 may clash with "Switch to Desktop N" if Spaces shortcuts are enabled — just pick another key (the red hint flags it).

Build from source

Requires macOS 13+ and the Swift 6 toolchain.

git clone https://github.com/hunters1431/MACKey.git
cd MACKey
swift run             # run (debug)
./scripts/make_icon.swift  # regenerate the app icon (optional)
./scripts/package.sh  # produce MACKey.app + DMG

Built with Swift + SwiftUI + AppKit; global hotkeys via HotKey.

Support

If MACKey helps you, consider supporting development — see the "☕ Support" item in the menu, or Ko-fi / PayPal.

License

MIT