gitwtfhub

wtf is masshortcut?

rxhanson/masshortcut — explained in plain English

Analysis updated 2026-08-08 · repo last pushed 2025-09-28

14Objective-CAudience · developerComplexity · 2/5QuietLicenseSetup · moderate

TL;DR

A framework for Mac app developers that lets users set custom global keyboard shortcuts, with a built-in shortcut-recording UI and system-wide hotkey detection that works inside the Mac App Store sandbox.

Mindmap

mindmap
  root((repo))
    What it does
      Records keyboard shortcuts
      Saves to app preferences
      Listens system-wide
    Tech stack
      Objective-C
      Cocoa and AppKit
      Carbon hotkey APIs
    Use cases
      Screenshot apps
      Clipboard managers
      Window resizing tools
    Audience
      Mac app developers
      Productivity tool makers
    Notable details
      App Store compatible
      Migration from Shortcut Recorder
      Multi-language localization

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

Why would anyone build with this?

REASON 1

Add a global hotkey to a Mac utility app so users can trigger actions from anywhere

REASON 2

Give users a settings screen where they can record their own preferred keyboard shortcuts

REASON 3

Migrate an existing app from Shortcut Recorder to a maintained shortcut framework

REASON 4

Build a screenshot or clipboard manager app with configurable system-wide triggers

What's in the stack?

Objective-CCocoaAppKitCarbon

How it stacks up

rxhanson/masshortcutezzuldinst/lspoofseanghay/betterkhmer
Stars141414
LanguageObjective-CObjective-CObjective-C
Last pushed2025-09-28
MaintenanceQuiet
Setup difficultymoderatehardeasy
Complexity2/54/52/5
Audiencedeveloperdeveloperdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires linking the Objective-C framework into an Xcode project and building a Mac app.

Use freely in your projects, including commercial Mac apps, as long as you include the copyright notice.

Wtf does this do

MASShortcut is a tool for Mac app developers who want to let their users set custom global keyboard shortcuts, the kind that trigger an action even when the app isn't front and center. Instead of building that functionality from scratch, a developer can drop this framework in and get a polished shortcut-recording UI plus the underlying logic for free. At a high level, it does three things: it provides a visual control where users press a key combination to record a shortcut, it saves that shortcut to the app's preferences so it persists across launches, and it listens for that key combination system-wide and runs whatever action the developer has tied to it. The developer just places the provided view into their app's settings screen, tells it which preference key to store the shortcut under, and connects that key to a block of code to run when the shortcut fires. This is aimed at Mac app developers building productivity tools, utilities, or any app where power users want quick access via hotkey. For example, if you're building a screenshot app, a clipboard manager, or a window-resizing tool, your users would expect to press something like Cmd+Shift+4 from anywhere on their Mac to trigger your app. This framework handles that entire flow. One notable detail is that it's explicitly designed to be Mac App Store compatible, which matters because Apple's sandboxing rules can make global shortcut handling tricky. It also offers backward compatibility with an older framework called Shortcut Recorder, so developers migrating from that tool don't lose shortcuts their users already saved. The project includes localization support for several languages and comes with a demo app showing real usage.

Yoink these prompts

Prompt 1
How do I add MASShortcut to my Xcode project and place the shortcut recording view in my settings window?
Prompt 2
Show me how to save a recorded shortcut to NSUserDefaults and run a code block when the user presses that hotkey globally.
Prompt 3
How can I migrate my existing Shortcut Recorder shortcuts to MASShortcut without losing my users' saved key combos?
Prompt 4
Is MASShortcut compatible with Mac App Store sandboxing, and what entitlements do I need for global hotkeys?

Frequently asked questions

wtf is masshortcut?

A framework for Mac app developers that lets users set custom global keyboard shortcuts, with a built-in shortcut-recording UI and system-wide hotkey detection that works inside the Mac App Store sandbox.

What language is masshortcut written in?

Mainly Objective-C. The stack also includes Objective-C, Cocoa, AppKit.

Is masshortcut actively maintained?

Quiet — no commits in 6-12 months (last push 2025-09-28).

What license does masshortcut use?

Use freely in your projects, including commercial Mac apps, as long as you include the copyright notice.

How hard is masshortcut to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is masshortcut for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.