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