Hammerspoon Configuration
Hammerspoon is a tool for powerful automation of OS X. Hammerspoon gets its power from a set of extensions that expose specific system functionality to the user.
Installation
You can follow the Hammerspoon getting started guide to get everything set up. Once you've got it downloaded and a basic config working, so that you know that everything is working, follow these steps:
git clone [email protected]:Linell/hammerspoon-config.git ~/.hammerspoonNow go up to the hammer icon in your menu, click it, and select 'Reload Config'.
You should get a fancy "Hammerspoon, at your service" message and cool alert noise. Boom,
installation complete. Note that you made need to make alert.wav executable -- chmod 777 alert.wav may help.
Usage
You should definitely check out init.lua for the full "how to use" experience. That's where
all of the usage is defined, after all. For a brief breakdown though, here's what does what:
- "mash" refers to pressing ⌘ + ⌥ + ⌃ at once.
- "mashshift" refers to pressing ⌘ + ⌥ + ⇧ at once.
| Key Combination | Description |
|---|---|
| mash + ; | Snaps the focused window to the grid. |
| mash + ' | Snaps all visible windows to the grid. |
| mash + = | Adds a column to the width of the grid. |
| mash + - | Removes a column from the width of the grid. |
| mashshift + = | Adds a row to the height of the grid. |
| mashshift + - | Removes a row from the height of the grid. |
| mashshift + ← | Focuses on the window to the left of the current window. |
| mashshift + → | Focuses on the window to the right of the current window. |
| mashshift + ↑ | Focuses on the window above the current window. |
| mashshift + ↓ | Focuses on the window below the current window. |
| mash + M | Maximize the current window. |
| mash + F | Make the current window fullscreen. |
| mashshift + F | Make the current window not fullscreen. |
| mash + N | Pushes the current window to the next monitor. |
| mash + P | Pushes the current window to the previous monitor. |
| mash + U | Makes the current window taller. Only works if there is room for the window to get bigger downward. |
| mash + O | Makes the current window wider. Only works if there is room for the window to get bigger to the right. |
| mash + I | Makes the window thinner, from right to left. |
| mash + Y | Makes the window shorter, from bottom to top. |
| mashshift + spacebar | Display currently playing song in Spotify. |
| mashshift + P | Start playing Spotify. |
| mashshift + O | Pause Spotify. |
| mashshift + N | Skip to next song on Spotify. |
| mashshift + I | Skip to previous song on Spotify. |
| mashshift + ] | Increase volume by increment of 5 |
| mashshift + [ | Decrease volume by increment of 5 |
| mashshift + T | Shows the current date and time. |
Hopefully that'll help you get a jump start on what everything does!