https://github.com/mikker/leaderkey.app
The *faster than your launcher* launcher
https://github.com/mikker/leaderkey.app
macos macos-app
Last synced: 2 months ago
JSON representation
The *faster than your launcher* launcher
- Host: GitHub
- URL: https://github.com/mikker/leaderkey.app
- Owner: mikker
- License: mit
- Created: 2024-08-12T08:58:31.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-03-31T07:51:51.000Z (3 months ago)
- Last Synced: 2025-04-06T16:04:49.952Z (2 months ago)
- Topics: macos, macos-app
- Language: Swift
- Homepage: https://mikkelmalmberg.com/apps
- Size: 4.34 MB
- Stars: 1,394
- Watchers: 13
- Forks: 42
- Open Issues: 36
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
**The \*faster than your launcher\* launcher**
A riff on [Raycast](https://www.raycast.com), [@mxstbr's multi-key Karabiner setup](https://www.youtube.com/watch?v=m5MDv9qwhU8&t=540s), and Vim's `` key.
Watch the intro video on YouTube:
*Yes, I only have that one thumbnail face.*
📦 [Download latest version](https://github.com/mikker/LeaderKey.app/releases)
```sh
$ brew install leader-key
```
## Why Leader Key?
### Problems with traditional launchers:
1. Typing the name of the thing can be slow and give unpredictable results.
2. Global shortcuts have limited combinations.
3. Leader Key offers predictable, nested shortcuts -- like combos in a fighting game.
### Example Shortcuts:
- leaderom → Launch Messages (`open messages`)
- leadermm → Mute audio (`media mute`)
- leaderwm → Maximize current window (`window maximize`)
## FAQ
#### What do I set as my Leader Key?
Any key can be your leader key, but **only modifiers will not work**.
**Examples:**
- F12
- ⌘ + space
- ⌘⌥ + space
- ⌘⌥⌃⇧ + L (hyper key)
**Advanced examples:**
Using [Karabiner](https://karabiner-elements.pqrs.org/) you can do more fancy things like:
- right ⌘ + left ⌘ at once (bound to F12) my personal favorite
- caps lock (bound to hyper when held, F12 when pressed)
See [@mikker's config](https://github.com/mikker/LeaderKey.app/wiki/@mikker's-config) in the wiki for akimbo cmds example.
#### I disabled the menubar item, how can I get Leader Key back?
Activate Leader Key, then cmd + ,.
## License
MIT