More extensions will always be a huge benefit to Hammerspoon. You can learn more about the Lua scripting language at lua.org. If you are new to Hammerspoon, read the Getting Started Guide with reference to the full API documentation. You will need to create a Lua script in ~/.hammerspoon/a using our APIs and standard Lua APIs. Out of the box, Hammerspoon does nothing. If you are using an older Mac which is not running a recent version of macOS, please consult our Release Notes for a version which is compatible with your system. How do I install it?ĭownload the latest release and then drag the application to /Applications/. You might want to do something crazy like have iTunes automatically start playing when your Mac detects you are in Paris. You might want to display an alert when your battery drops below a certain percentage.

You might want to run a series of commands when your wifi interface connects to your home network. You might want to bind a keyboard shortcut to a series of window operations, or an applescript. Typically you would write a configuration file in Lua that connects events to actions.

If you want to explore the options Hammerspoon offers, check out the Getting Started Guide and the full API documentation as well as the already pre-made plugins called Spoons. You can write Lua code that interacts with macOS APIs for applications, windows, mouse pointers, filesystem objects, audio devices, batteries, screens, low-level keyboard/mouse events, clipboards, location services, wifi, and more. What gives Hammerspoon its power is a set of extensions that expose specific pieces of system functionality, to the user. At its core, Hammerspoon is just a bridge between the operating system and a Lua scripting engine. The goal here is to take a table that can contain top, left, width, and/or height as numbers 0 to 1 and then apply those to the current window, defaulting left and top to 0 and width and height to 1.This is a tool for powerful automation of macOS. Return true end function thunk_grid(cell) WindowFrame.h = cas(windowFrame.h, screenFrame.h * (params or 1)) WindowFrame.w = cas(windowFrame.w, screenFrame.w * (params or 1)) WindowFrame.y = cas(windowFrame.y, screenFrame.y + (screenFrame.h * (params or 0))) If old ~= new then moved = true end return newĮnd windowFrame.x = cas(windowFrame.x, screenFrame.x + (screenFrame.w * (params or 0))) Local moved = false function cas(old, new) Local window = params or hs.window.focusedWindow() Move a window to the given coordinates - top/left/width/height as a percent of the screen - window (optional) the window to move, defaults to the focused window function push(params) Pushing windows aroundįirst, to snap windows, I implemented a few functions in ~/.hammerspoon/functions/a: Sometimes to my own detriment, I like to be able to take a sane set of defaults and then tweak them how I want. Rectangle Pro - it’s… a separate app? but with “Arrange an entire workspace of apps with just one shortcut.” this might do exactly what I wantīut finally (for the time being), I came back to Hammerspoon.Rectangle - follow up to Spectacle, really is pretty much the same thing as Magnet.i3 / awesome - automatic tiling I don’t think I’m quite ready for this yet, perhaps another day?.

yabai - requires disabling SIP, is CLI 👍 but needs another tool for keyboard shortcuts 👎.Divvy - works pretty well, especially for automatically tiling and grid layout, although having to specify the grid with the mouse is suboptimal.Mostly, I sent out a call for what other options there were and tried them out: Sending windows to the correct screen/desktop.the ability to automatically arrange windows to various Mission Control Spaces.a bit more control (once again), to define more arbitrary sizes and keystrokes.Since then, I eventually discovered and moved to Magnet and all was well.īut more recently, I’ve been wanting two things: I missed Aerospace–the ability to use Win+Left/Right to snap windows to half the screen–so I wrote a fix: Duplicating AeroSnap on OSX with Hammerspoon. Once upon a time, I moved from primarily Windows to primarily (at the time) OSX. Why oh why doesn’t macOS have a more powerful window manager…

Hammerspoon divvy like grid