These Hammerspoon scripts are designed to enhance the usability and productivity of macOS by providing various workspace management features. The scripts currently help display time near the mouse cursor, prevent the menu bar from appearing, automatically tile windows of whitelisted applications, and open URLs in different browsers.
FrameMaster.lua - Take control of your Mac's 'hot corners', menu bar, and dock. Master your screen frame and manage your workflow with minimal distractions.
- Hot corners: Define custom actions for each corner of the screen. Actions are defined in the hotCorners table and can be updated as needed.
- Keep the dock and menubar hidden.
- Reopen last app: When an app is killed, a modal will be shown to allow you to easily reopen it.
| Action | Shortcut |
|---|---|
| Close or Quit App | Move mouse to the top-left corner |
| Kill Frontmost App | ⇧ SHIFT + move mouse to the top-left corner |
| Reopen Last App Modal | Automatically shown when an app is killed |
| Toggle Fullscreen | Move mouse to the top-right corner |
| Zoom Window | ⇧ SHIFT + move mouse to the top-right corner |
| Minimize Window | Move mouse to the bottom-right corner |
| Hide App | ⇧ SHIFT + move mouse to the bottom-right corner |
| Open Finder | Move mouse to the bottom-left corner |
| Open System Preferences | ⇧ SHIFT + move mouse to the bottom-left corner |
HyperlinkHijacker.lua - It's your link, and you decide where it goes.
| Action | Shortcut |
|---|---|
| Open link in the first browser | Click the link and wait |
| Choose browser to open link | Click link and select from the list |
| Bypass chooser and open directly | ⇧ SHIFT + Click the link |
| Copy link to clipboard | Select "Copy to Clipboard" from the list |
MenuMaestro.lua - Easily access menu items and shortcuts with a visually appealing interface.
| Action | Shortcut |
|---|---|
| Activate menu chooser | ^ CTRL⌥ ALTSPACE or tap with 5 fingers on trackpad |
| Search and select menu item | Type and choose with keyboard/mouse |
Sssssssscroll.lua - Use mouth noises to scroll.
| Action | Sound/Shortcut |
|---|---|
| Toggle listener on/off | ⌘ CMD⌥ ALT^ CTRLS |
| Continuous scroll | Make a continuous "Ssssssss" sound |
| Single action | Make a single water drop sound (lip pop) |
| Double action | Make two quick water drop sounds (lip pops) |
Note: Actions may vary depending on the active application. Default actions include scrolling down, scrolling up, and pressing Shift+Space.
TrackpadKeys.lua adds a row of keys to the top of the trackpad.
| Action | Shortcut |
|---|---|
| Activate virtual keyboard row | Swipe top edge of trackpad |
| Input uppercase letters | Touch bottom corner while swiping the top |
WindowScape.lua is the ultimate tool in window organization, transforming chaos into a neat urban landscape.
- Automatically tiles windows of whitelisted applications (or set it to avoid tiling the apps listed there).
| Action | Shortcut |
|---|---|
| Add/Remove app to/from whitelist | ^ CTRL⌘ CMD< |
| Move window backward in tiling order | ^ CTRL⌘ CMD← or 3 fingers touch + a tap to the left |
| Move window forward in tiling order | ^ CTRL⌘ CMD→ or 3 fingers touch + a tap to the right |
| Move window to previous space | ^ CTRL⌘ CMD⌥ ALT← or 4 fingers touch + a tap to the left |
| Move window to next space | ^ CTRL⌘ CMD⌥ ALT→ or 4 fingers touch + a tap to the right |
ZXNav.lua - Moves text navigation and editing actions closer to the spacebar for easier reach.
| Action | Shortcut |
|---|---|
| Moving Around | |
| Jump to the start of the line (Home) | SPACEZ |
| Jump to the end of the line (End) | SPACEX |
| Move up a line | SPACEC |
| Move down a line | SPACEV |
| Move left | SPACEB |
| Move right | SPACEN |
| Text Manipulation | |
| Munch characters (Delete) | SPACEM |
| Insert a new line (Return) | SPACE, |
Q: How do I use these scripts?
A: To use these scripts, you need to have Hammerspoon installed on your macOS system. Once you have Hammerspoon installed, clone this repository to your local machine, copy or symlink the desired script(s) to your Hammerspoon configuration directory, and add a line to your init.lua file to require the script(s). Reload your Hammerspoon configuration, and the scripts will start working automatically.
Q: Are these scripts free to use?
A: Yes, these scripts are free to use, modify, and distribute. If you find these scripts useful and want to support their development, consider sharing them with others, contributing improvements, or reporting any issues you encounter.