awesome configuration for Hammerspoon.
Switch branches/tags
Nothing to show
Clone or download
Latest commit 2f65650 Apr 23, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Spoons Typos Apr 20, 2018
.gitignore Add .gitignore Aug 17, 2017
LICENSE Initial commit Aug 17, 2017
README.md Update README.md Nov 21, 2017
config-example.lua Make keybindings could be diabled Aug 18, 2017
init.lua code format(4 spaces) Nov 8, 2017

README.md

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

  1. Install Hammerspoon first.

  2. git clone https://github.com/ashfinal/awesome-hammerspoon.git ~/.hammerspoon

  3. 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

widgets

Window manpulation + R

More details

winresize

Search something + G

More details

hsearch

aria2 Frontend + D

More details

hsearch

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 SECRET

Customization

More details
cp ~/.hammerspoon/config-example.lua ~/.hammerspoon/private/config.lua

Then modify the file ~/.hammerspoon/private/config.lua:

  • Add/remove Spoons.

    Define hspoon_list 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

    Please read ~/.hammerspoon/private/config.luafor more details.

Finally press cmd + ctrl + shift + r to reload the configuration.

Contribute

More details

Thanks to

More details

https://github.com/zzamboni/oh-my-hammerspoon

https://github.com/scottcs/dot_hammerspoon

https://github.com/dharmapoudel/hammerspoon-config

http://tracesof.net/uebersicht/