A config for Hammerspoon

Requirements

• Karabiner-elements is required to bind Capslock key (or any other of your choice) to the Hyper key (combination of Shift, Option, Control and Command).
  • Install Karabiner-elements manually or via brew:

      brew install --cask karabiner-elements
    

  • Open it and go to the tab Complex modifications.
  • Click Add rule in the bottom left corner.
  • Enable the option Change caps_lock to command+control+option+shift.
• Go to System Preferences -> Security & Privacy -> Privacy and add both Hammerspoon and Karabiner-Elements in the Accessibility tab

How to use it

1. Install Hammerspoon

   brew install --cask hammerspoon
   

2. Clone this repository into your ~/.hammerspoon directory:

   git clone [email protected]:levinine/hammerspoon-config.git ~/.hammerspoon
   

3. Review init.lua and change or disable any features as needed.

4. Run Hammerspoon. All the necessary Spoons will be downloaded, installed and configured automatically

5. Voila. Hammerspoon docs can be found here Hammerspoon website can be found here

Features

• Hyper bindings
  • Binds multiple hotkeys to run various apps
• Web mode binder
  • Binder mode to:
    • open pages in browser
    • copy URL of current window
    • extract Jira ticket number from current window
• Teams toggle mute
  • Binds a hotkey which triggers toggle mute on Teams and focuses the application
• Window Management
  • Set window to full-screen mode
  • Maximize a window (not the full-screen mode)
  • Set window to 50% width left or right
  • Move window to another display
  • Show a split window popup for splitting two apps on the screen
  • Move mouse to the closest edge of the current window.
• Keyboard layout switcher
  • Toggle different keyboard layouts
  • Colorize the menu bar based on the chosen layout
• Translation popup
  • Binds a hotkey which triggers a popup with Google Translate of the selected text
• Vpn connection
  • Binds a hotkey which triggers connection to VPN using Tunnelblick
• Text manipulation
  • To uppercase
  • To lowercase
• Jwt token paster
  • Pastes a long JWT token
• Hold to quit
  • Requires the user to hold CMD + Q in order to quit the app and shows a proper message
• Mouse finder
  • Binds a hotkey used to locate your mouse on the screen
• Audio watcher/toggler
  • Toggle output audio device
  • Show a menu bar item with a prefix of the device. Click on the menu bar toggles the device
• Wifi watcher
  • Toggle connected Wi-Fi network
  • Show a menu bar item showing: LAN+WifiNetworkPrefix or just WifiNetworkPrefix if LAN is not connected . Click on the menu bar toggles the Wi-Fi network
• Rounded corners
  • Renders nice mac friendly rounded corners on the screen
• Keypress show
  • Provide an easy way of showing keystrokes on the screen. It's inspired by other tools like Keycastr.

Inspiration, copycat sources, ideas, etc sources:

• https://github.com/babarrett/hammerspoon/
• https://github.com/miromannino/miro-windows-manager
• https://github.com/zzamboni/hammerspoon-config
• https://github.com/cmsj/hammerspoon-config
• https://github.com/kev-zheng/hammerspoon
• https://github.com/evantravers/hammerspoon-config
• https://gist.github.com/ysimonson/fea48ee8a68ed2cbac12473e87134f58
• https://www.reddit.com/r/hammerspoon/
• https://medium.com/@robhowlett/hammerspoon-the-best-mac-software-youve-never-heard-of-40c2df6db0f8
• https://spinscale.de/posts/2016-11-08-creating-a-productive-osx-environment-hammerspoon.html
• https://gist.github.com/spartanatreyu/850788a0441e1c5565668a35ed9a1dfc
• https://github.com/Linell/hammerspoon-config