dot-hammerspoon

dot-hammerspoon is my personal configuration for Hammerspoon, and you can modify to suit your needs and preferences.

Features

Application quick launch or hide.
Application window manipulation, such as moving, resizing, changing position, etc.
System management, such as lock screen, restart system, etc.
Auto switch input method according to the application.
Switch to the specified input method.
Open the specified website directly.
Toggle the keybindings cheatsheet.
Keep the desktop wallpaper the same as the bing daily picture.
Auto reload configuration when lua files changes.
The code structure is clear and easy to customize into your own configuration.

Installation

Install Hammerspoon first: brew install hammerspoon --cask
Run Hammerspoon.app and follow the prompts to enable Accessibility access for the app.
git clone --depth 1 https://github.com/windvalley/dot-hammerspoon.git ~/.hammerspoon

Keep update:

cd ~/.hammerspoon && git pull

Usage

Toggle Keybindings Cheatsheet

⌥ + /

Switch to the specified Input Method

⌥ + 1: ABC
⌥ + 2: Pinyin

System Management

⌥ + Q: Lock Screen
⌥ + S: Start Screensaver
⌃⌥⌘⇧ + R: Restart Computer
⌃⌥⌘⇧ + S: Shutdown Computer

Website Open

⌥ + 8: github.com
⌥ + 9: google.com
⌥ + 7: bing.com

Application Launch or Hide

⌥ + H: Hammerspoon Console
⌥ + F: Finder
⌥ + I: Alacritty
⌥ + C: Chrome
⌥ + N: YNote
⌥ + M: Mail
⌥ + O: VirtualBox
⌥ + D: DeepL
⌥ + P: Postman
⌥ + E: Excel
⌥ + V: VSCode
⌥ + W: WeChat

Window Manipulation

Window Position

⌃⌥ + C: Center Window
⌃⌥ + K: Up Half of Screen
⌃⌥ + J: Down Half of Screen
⌃⌥ + H: Left Half of Screen
⌃⌥ + L: Right Half of Screen
⌃⌥ + U: Top Left Corner
⌃⌥ + I: Top Right Corner
⌃⌥ + O: Bottom Left Corner
⌃⌥ + P: Bottom Right Corner
⌃⌥ + Q: Left or Top 1/3
⌃⌥ + W: Right or Bottom 1/3
⌃⌥ + E: Left or Top 2/3
⌃⌥ + R: Right or Bottom 2/3

Window Resize

⌃⌥ + M: Max Window
⌃⌥ + =: Stretch Outward
⌃⌥ + -: Shrink Inward
⌃⌥⌘⇧ + K: Bottom Side Stretch Upward
⌃⌥⌘⇧ + J: Bottom Side Stretch Downward
⌃⌥⌘⇧ + H: Right Side Stretch Leftward
⌃⌥⌘⇧ + L: Right Side Stretch Rightward

Window Movement

⌃⌥⌘ + K: Move Upward
⌃⌥⌘ + J: Move Downward
⌃⌥⌘ + H: Move Leftward
⌃⌥⌘ + L: Move Rightward

Window Monitor

⌃⌥ + UP: Move to Above Monitor
⌃⌥ + DOWN: Move to Below Monitor
⌃⌥ + LEFT: Move to Left Monitor
⌃⌥ + RIGHT: Move to Right Monitor
⌃⌥ + SPACE: Move to Next Monitor

Window Batch

⌃⌥⌘ + M: Minimize All Windows
⌃⌥⌘ + U: Unminimize All Windows
⌃⌥⌘ + Q: Close All Windows

Keybindings Customization

Modify the file ~/.hammerspoon/keybindings_config.lua according to your keystroke habits.

Some Useful Shortcuts Come With macOS

More details

Desktop

⌃ + RIGHT: Switch to right desktop
⌃ + LEFT: Switch to left desktop
⌃ + UP: Toggle tiling windows
⌥⌘ + D: Toggle dock

Application

⌘ + Q: Close app
⌘ + ,: Open the app's preferences
⌘⇧ + /: Toggle help

Window

⌘ + H: Hide window
⌘ + M: Minimize window
⌘ + N: New window
⌘ + W: Close window
⌘ + `: Switch between windows of the same application
⌃⌘ + F: Toggle window fullscreen
⌃⌘ + H: Hide all windows except the current one

Window Tab

⌘⇧ + [: Switch to the left tab
⌘⇧ + ]: Switch to the right tab
⌘ + NUMBER: Switch to the specified tab
⌘ + 9: Switch to the last tab

Cursor

⌃ + P: Move the cursor up
⌃ + N: Move the cursor down
⌃ + B: Move the cursor back/left
⌃ + F: Move the cursor forward/right
⌃ + A: Move the cursor to the beginning of the line
⌃ + E: Move the cursor to the end of the line

File

⌘ + BACKSPACE: Delete the selected file
⌘ + DOWN: Go to a directory or open a file
⌘ + UP: Back to the upper level directory
⌘⇧ + BACKSPACE: Clear the Trash

Others

⌘ + +: Expand font size
⌘ + -: Shrink font size
⌘ + 0: Reset font size
⌘ + Z: Undo
⌘⇧ + Z: Redo
⌘ + C: Copy
⌘ + V: Paste
⌘⌥ + V: Paste and delete the original object

Acknowledgments

License

This project is under the MIT License. See the LICENSE file for the full license text.

WPF0414 / dot-hammerspoon