https://github.com/zfdang/hammerspoon-config
personal config for hammerspoon
https://github.com/zfdang/hammerspoon-config
Last synced: 10 months ago
JSON representation
personal config for hammerspoon
- Host: GitHub
- URL: https://github.com/zfdang/hammerspoon-config
- Owner: zfdang
- License: mit
- Created: 2021-09-26T04:27:14.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-06-01T01:15:31.000Z (about 1 year ago)
- Last Synced: 2025-06-01T11:39:45.188Z (about 1 year ago)
- Language: Lua
- Size: 56.6 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# HammerSpoon config
Personal config for hammerspoon
## install HammerSpoon
### Click here to download the latest version:
https://github.com/Hammerspoon/hammerspoon/releases/latest
### Or, install through brew:
`brew install --cask hammerspoon`
NOTE: You might have to grant "accessibility" permission to HammerSpoon manually. Please follow instruction in "preference" page.
## how to use this config
```
brew install blueutil
rm -rf ~/.hammerspoon
git clone https://github.com/zfdang/hammerspoon-config.git ~/.hammerspoon --depth 1
git clone git@github.com:zfdang/hammerspoon-config.git ~/.hammerspoon --depth 1
```
then reload hammerspoon config
## Main features
1. Quick launch / switch among apps
2. Move apps among monitors
3. Resize and Adjust position of windows
4. Lock Screen
5. Show battey status
6. Adjust Volume
7. Adjust screen brightness
8. Turn off Bluetooth when sleep, avoid connections to Bluetooth devices during sleep. Depends on blueutil.
## Current key bindings and functions
HyperKey: {"cmd", "alt", "ctrl", "shift"}
- HyperKey + l: lock screen
- HyperKey + b: show battery status on screen
- HyperKey + [: move app to left screen
- HyperKey + ]: move app to right screen
- HyperKey + return: maximize current window
- HyperKey + left: resize current window to the left half of the screen
- HyperKey + right: resize current window to the right half of the screen
- HyperKey + up: resize current window to the top half of the screen
- HyperKey + down: resize current window to the bottom half of the screen
- HyperKey + x: launch application by x (see key2App in [key-bindings.lua](key-bindings.lua), you can customize it in your own way)
- {"CMD","Ctrl"} + up: volume up
- {"CMD","Ctrl"} + down: volume down
-
- {"option","Ctrl"} + up: screen brightness up
- {"option","Ctrl"} + down: screen brightness down