Oh-my-Hammerspoon!

A configuration framework for Hammerspoon

Very early work in progress, feedback very welcome.

Check out this repository onto your ~/.hammerspoon directory:

git clone https://github.com/zzamboni/oh-my-hammerspoon.git ~/.hammerspoon

Edit init.lua to enable/disable the plugins you want (at the moment they are all enabled by default).
Copy init-local-sample.lua to init-local.lua and modify to change plugin configuration parameters or add your own arbitrary code.

This config has already replaced my use of the following apps:

ClipMenu - clipboard history, supporting both text and image entries. See clipboard.lua.
- Shift-Cmd-v shows the clipboard menu.
Choosy and other URL dispatchers - allows opening URLs in different applications depending on regular expression matching. Great if you use site-specific browsers created with Epichrome or Fluid. See url_handling.lua.
Breakaway - automatically pause/unpause music when headphones are unplugged/replugged. Only for Spotify app at the moment, and it needs latest Hammerspoon built from source (which includes the audio device watcher). See headphones_watcher.lua.
Spectacle - window manipulation. Only some shortcuts implemented, those that I use, but others should be easy to add. See manipulation.lua.
- Ctrl-Cmd-left/right/up/down - resize the current window to the corresponding half of the screen.
- Ctrl-Alt-left/right/up/down - resize and move the current window to the previous/next horizontal/vertical third of the screen.
- Ctrl-Alt-Cmd-F or Ctrl-Alt-Cmd-up - maximize the current window.
- Ctrl-Alt-Cmd-left/right - move the current window to the previous/next screen (if more than one monitor is plugged in).
ShowyEdge - menu bar coloring to indicate the currently selected keyboard layout (again, only the indicators I use are implemented, but others are very easy to add). See menubar_indicator.lua.

It additionally provides the following functionality:

"Universal Archive" (universal_archive.lua) for archiving the current item in different applications. At the moment Evernote and Mail.app are supported.
Automatic/manual configuration reloading (hammerspoon_config_reload.lua)
- Ctrl-Alt-Cmd-r - manual reload, or when any *.lua file in ~/.hammerspoon/ changes.
A color sampler/picker (colorpicker.lua)
- Ctrl-Alt-Cmd-c toggles a full-screen color picker of the colors in hs.drawing.color (this is more impressive with a larger list of colors, like the one in PR#611). Clicking on any color will copy its name to the clipboard, Cmd-clicking copies its RGB code.
Mouse locator (mouse/locator.lua).
- Ctrl-Alt-Cmd-d draws a red circle around the mouse for 3 seconds.
Skype mute/unmute (skype_mute.lua)
- Ctrl-Alt-Cmd-Shift-v mutes/unmutes Skype, regardless of whether it's the frontmost application.

It has drawn inspiration and code from many other places, including: