whatisgithub

What is mackey?

hunters1431/mackey — explained in plain English

Analysis updated 2026-05-18

14SwiftAudience · generalComplexity · 2/5Setup · easy

In one sentence

A free macOS menu-bar app for looking up system keyboard shortcuts and assigning custom hotkeys to launch or switch between apps.

Mindmap

mindmap
  root((repo))
    What it does
      Lookup system shortcuts
      Assign custom hotkeys
      Launch apps by keypress
    Tech stack
      Swift
    Use cases
      Switch between apps
      Discover shortcuts
      Avoid hotkey conflicts
    Audience
      Mac users
    Privacy
      No network access
      No account needed

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Switch instantly between your ten most-used apps using Control plus a number key.

USE CASE 2

Assign a custom keyboard shortcut to any installed application.

USE CASE 3

Look up built-in macOS system shortcuts ranked by how commonly they are used.

USE CASE 4

Check whether a hotkey you want to assign is already taken by the system.

What is it built with?

Swift

How does it compare?

hunters1431/mackeytnt-likely/panbarvaleriy777-ua/soundknobs
Stars141414
LanguageSwiftSwiftSwift
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencegeneralgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Not notarized with a paid Apple Developer account, so macOS blocks the first launch until you right-click and confirm.

Free and open source, specific license terms are not stated in the explanation.

So what is it?

MACKey is a free, open-source macOS menu-bar application for managing and discovering keyboard shortcuts. It sits quietly in your menu bar and gives you a three-column panel to look up built-in system shortcuts, assign custom hotkeys to any application, and launch your most-used apps with a single keypress. The app ships with your first 10 Dock apps already bound to Control+1 through Control+0, so you can switch between your most-used programs without any initial setup. Beyond those defaults, you can assign any key combination to any installed app you choose. MACKey checks for conflicts in real time while you record a new combo and shows a named warning, such as "taken by the system's Screenshot," so you know immediately what is already claimed. The shortcut reference panel shows macOS system shortcuts ranked by how commonly they are used in practice, which saves hunting through Apple's System Settings. Your own customizations appear in a live-synced middle column alongside that reference. A third column covers the Dock-order bindings and lets you click any field to reassign it. MACKey runs entirely on your Mac with no network connection required. There is no account to create, no tracking, and no data leaves your machine. It launches at login and supports both English and Chinese. It requires macOS 13 or later and runs natively on Apple Silicon, which the README notes as a successor to an older Intel-era tool called Snap. Installation is a standard drag-to-Applications process from a downloaded DMG file. Because the app is not notarized through a paid Apple Developer account, macOS will block the first launch, a right-click and a one-time confirmation bypasses this. The app also needs Accessibility permission in System Settings to register global hotkeys.

Copy-paste prompts

Prompt 1
Explain how to assign a custom keyboard shortcut to an app using MACKey.
Prompt 2
Explain why macOS blocks the first launch of MACKey and how to get past that safely.
Prompt 3
Explain what Accessibility permission MACKey needs and why it needs it.
Prompt 4
List the default keyboard shortcuts MACKey sets up out of the box.

Frequently asked questions

What is mackey?

A free macOS menu-bar app for looking up system keyboard shortcuts and assigning custom hotkeys to launch or switch between apps.

What language is mackey written in?

Mainly Swift. The stack also includes Swift.

What license does mackey use?

Free and open source, specific license terms are not stated in the explanation.

How hard is mackey to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is mackey for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.