MultiShortcuts Pro for Mac · v2.0.0 beta
Taking shortcuts to a whole new level.
© 2026 GnuKey LLC.

Licensed under the MIT License. See terms.html for full terms.


FILES
=====

  MultiShortcutsPro.lua              The Hammerspoon script.
  multishortcutspro-karabiner.json   Karabiner-Elements rules for the
                                     hold keys (hold ; = Command, hold `
                                     or Caps Lock = Option, middle mouse).
                                     The same rules are embedded in the
                                     script's "Set up hold keys" menu item.


THIRD-PARTY DEPENDENCIES
========================

MultiShortcuts Pro runs on top of Hammerspoon, a free, open-source
automation framework for macOS by Chris Jones and contributors.

  Hammerspoon                https://www.hammerspoon.org
  License                    MIT
  Distributed separately     YES. Users install Hammerspoon themselves.
                             MultiShortcuts Pro does NOT bundle, modify,
                             or redistribute Hammerspoon.

It uses only Hammerspoon's built-in modules:

  hs.eventtap      hs.keycodes      hs.hotkey
  hs.pasteboard    hs.timer         hs.application
  hs.urlevent      hs.fs            hs.menubar
  hs.dialog        hs.chooser       hs.notify
  hs.json          hs.sound         hs.pathwatcher
  hs.task          hs.host          hs.alert

The hold keys use Karabiner-Elements (optional, recommended).

  Karabiner-Elements         https://karabiner-elements.pqrs.org/
  License                    Public domain / Unlicense
  Distributed separately     YES. MultiShortcuts Pro only supplies a
                             rule file that Karabiner-Elements reads.


OPTIONAL COMPANION TOOLS (NOT bundled or required)
==================================================

  Keyboard Maestro       https://www.keyboardmaestro.com/
                         For recording visual macros. Commercial.


CREDITS
=======

  Implementation              Claude (Anthropic)
  Code review and hardening   Gemini · DeepSeek

MultiShortcuts Pro for Windows (AutoHotkey) set the design for v2.0.0.
No code was ported; the Mac version is an independent implementation in
Lua for Hammerspoon.


TRADEMARK NOTICE
================

Mac, macOS, and Apple are trademarks of Apple Inc., registered in the
U.S. and other countries. MultiShortcuts Pro is NOT affiliated with,
endorsed by, or sponsored by Apple Inc. References to "Mac" and "macOS"
are descriptive, indicating the platform on which the software runs
(nominative fair use).

MultiShortcuts Pro and SpeedKee are trademarks of GnuKey LLC.


PRIVACY
=======

MultiShortcuts Pro runs entirely on your local Mac. It does not collect,
transmit, or log any data outside of your computer. No telemetry. No
analytics. No account required. The script makes no network calls.

Files it writes (shortcuts, usage statistics, preferences, backups) live
in ~/.hammerspoon/MultiShortcutsPro/. "Set up hold keys" also writes the
rule file to ~/.config/karabiner/assets/complex_modifications/.

Long expansions are pasted with the clipboard entry marked concealed and
transient (org.nspasteboard.ConcealedType / TransientType), so clipboard
managers skip them; the previous clipboard is restored afterwards.


CONTACT
=======

GnuKey LLC
support.team@gnukey.com
https://speedkee.com