awesome configuration for Hammerspoon.
awesome-hammerspoon configuration
awesome-hammerspoon is my configuration for Hammerspoon. It has highly modal-based, vim-style keybindings, provides some functionality like desktop widgets, window management, application launcher, instant search, aria2 frontend ... etc.
Get started
- Install Hammerspoon first.
git clone https://github.com/ashfinal/awesome-hammerspoon.git ~/.hammerspoon
- Reload the configutation.
Keep update
cd ~/.hammerspoon && git pull
How to use
Just press opt, plus A or C or R… to start. If need help, press tab to toggle the keybindings cheatsheet.
Press opt + ? to toggle the help panel, which will show all opt related keybindings.
Screenshots
These screenshots demostrate what awesome-hammerspoon is capable of. Learn more about built-in Spoons.
Desktop widgets
More details
Window manpulation ⌥ + R
More details
Search something ⌥ + G
More details
aria2 Frontend ⌥ + D
More details
You need to run aria2 with RPC enabled before using this. Config aria2 host and token in ~/.hammerspoon/private/config.lua, then you're ready to go.
hsaria2_host = "http://localhost:6800/jsonrpc" -- default host
hsaria2_secret = "token" -- YOUR OWN SECRETCustomization
cp ~/.hammerspoon/config-example.lua ~/.hammerspoon/private/config.luaThen modify the file ~/.hammerspoon/private/config.lua:
- Add/remove Spoons.
hspoonlist to decide which Spoons (a distributing format of Hammerspoon module) to be loaded. There are 15 built-in Spoons, learn about them at here.
There are more Spoons at official spoon repository (you may need a little config before using them).
- Customize keybindings
~/.hammerspoon/private/config.luafor more details.
Finally press cmd + ctrl + shift + r to reload the configuration.
Contribute
More details
- Improve existing Spoons
Feel free to file issues or open PRs.
- Create new Spoons
Getting Started with Hammerspoon
hammerspoon/SPOONS.md at master · Hammerspoon/hammerspoon
Thanks to
More details
https://github.com/zzamboni/oh-my-hammerspoon
https://github.com/scottcs/dot_hammerspoon
