Hammerspoon

Boosts productivity and adds useful features to OSX.

View project on GitHub

Hammerspoon

This is a script for Hammerspoon that provides several features and productivity boosts for OSX.

If you like or are using this config, please give it a for motivation :)

Image of window management

Features

  • Cross monitor window tiling using cmd + alt + direction
  • Window resizing using ctrl + cmd + alt + direction
  • Psuedo full screen using cmd + alt + f
  • Lock screen using cmd + alt + l
  • Disables window animations.
  • Redshift menubar item that allows variable screen temperature for easier night reading.
  • A 'caffeine' mode, which keeps the screen awake and disables notifications using cmd + alt + c or menubar.
  • A menubar dropdown to select primary screen resolution and DPI.
  • Automatically reloads when code is updated.

Installation

  1. Install Hammerspoon.
  2. Clone repository into your ~/.hammerspoon directory.
  3. Open Hammerspoon or reload your config.

Roadmap

  • Update README image and description.
  • Create documentation for each file.
  • Implement a settings file to manage all keyboard shortcuts.
  • Fix auto-reload to work consistently on all child directories.
  • Implement pomadoro module.
  • Make the window grid re-init on screen connect event so grids retain expected dimensions.
  • Multimonitor support for screen resolution dropdown.
  • Add Random.org random number generator to Conky.

Issues / Suggestions

Feel free to open an issue to give me suggestions, feedback or let me know if something doesn't work.

Credits

Resources

License

  • MIT, see LICENSE for more details.