- Updated: March 13, 2026
- 5 min read
Hammerspoon: Powerful macOS Automation Tool Gains New Features
Hammerspoon is an open‑source macOS automation framework that lets power users script and control virtually any aspect of macOS using the lightweight Lua language.
Why Hammerspoon Is the Ultimate macOS Automation Tool for Tech Enthusiasts
If you spend hours juggling windows, launching apps, or repeating mundane tasks on your Mac, you’ve probably wished for a smarter way to work. Hammerspoon delivers that magic by turning macOS into a programmable playground. In this article we break down its core features, highlight the latest GitHub updates, explore real‑world use cases, and show you how to get started in minutes.
Feature Overview: What Makes Hammerspoon Tick
- Lua‑based scripting engine – Write concise scripts in Lua, a language praised for its simplicity and speed.
- Extensive system extensions – Access window management, keyboard shortcuts, mouse events, network status, battery info, and more through built‑in modules.
- Live reloading – Changes to
~/.hammerspoon/init.luaare applied instantly, letting you iterate without restarting the app. - Event‑driven architecture – React to system notifications, USB device changes, or custom timers with minimal code.
- Open‑source & community‑driven – The project lives on GitHub, welcomes pull requests, and benefits from a vibrant community of macOS power users.
These capabilities combine to give you a productivity engine that can replace dozens of third‑party utilities, from window tilers to clipboard managers.
Recent GitHub Updates (April 2026)
The Hammerspoon GitHub repository saw a flurry of activity in its latest release (v0.10.2). Below are the most impactful changes for automation enthusiasts:
| Feature | Improvement |
|---|---|
| hs.window | Added moveToScreen with animation support, enabling smoother multi‑monitor workflows. |
| hs.hotkey | Introduced modal hotkeys, allowing temporary keymaps for focused tasks. |
| hs.network | New monitorChanges API that triggers scripts when Wi‑Fi networks appear or disappear. |
| Documentation | Expanded wiki with a step‑by‑step Hammerspoon tutorial covering common use cases. |
These updates tighten the integration between macOS APIs and Hammerspoon’s Lua bridge, making it easier than ever to build robust automation pipelines.
Benefits & Real‑World Use Cases
Window Management Mastery
With a few lines of Lua you can tile, snap, or cascade windows across multiple monitors. Example:
hs.hotkey.bind({"cmd","alt"}, "M", function()
local win = hs.window.focusedWindow()
win:moveToScreen(hs.screen.primaryScreen())
win:maximize()
end)This script binds ⌘⌥M to move the active window to the primary screen and maximize it—perfect for developers who switch between coding and design tools.
Automated Clipboard Workflows
Capture, transform, and re‑paste clipboard content on the fly. A common pattern is to clean up copied URLs:
hs.hotkey.bind({"cmd","alt"}, "C", function()
local txt = hs.pasteboard.getContents()
local clean = txt:gsub("^https?://", "")
hs.pasteboard.setContents(clean)
hs.alert.show("URL cleaned")
end)Now ⌘⌥C instantly strips the protocol, saving time when sharing links.
Network‑Aware Profiles
Switch audio output, VPN, or display settings based on the Wi‑Fi network you connect to. Example:
hs.network.wifi.watcher.new(function()
local ssid = hs.wifi.currentNetwork()
if ssid == "OfficeWiFi" then
hs.audiodevice.defaultOutputDevice():setName("Office Speakers")
else
hs.audiodevice.defaultOutputDevice():setName("MacBook Speakers")
end
end):start()This script ensures you always have the right audio configuration without manual toggling.
Scheduled System Maintenance
Run cleanup scripts during off‑hours. For instance, delete files older than 30 days from the Downloads folder every night:
hs.timer.doEvery(86400, function()
local cmd = "find ~/Downloads -type f -mtime +30 -delete"
hs.execute(cmd)
hs.alert.show("Old downloads cleared")
end)Automation like this keeps your Mac lean and responsive.
Getting Started with Hammerspoon in 5 Simple Steps
- Install the app – Download the latest release or use Homebrew:
brew install hammerspoon --cask. - Create the config file – Open
~/.hammerspoon/init.luain your favorite editor. If the folder doesn’t exist, create it. - Write your first script – Paste the “Hello World” snippet below and save:
hs.alert.show("Hello, Hammerspoon!")Reload Hammerspoon (⌘R) and watch the alert appear.
- Explore extensions – Browse the module list. Start with
hs.hotkeyandhs.windowfor quick wins. - Leverage community templates – The UBOS templates for quick start include ready‑made Hammerspoon snippets that you can drop into
init.lua. For example, the “Before‑After‑Bridge copywriting template” can be adapted to automate text generation workflows.
Once you’ve mastered the basics, you’ll discover that Hammerspoon can replace dozens of separate utilities, consolidating your workflow into a single, maintainable codebase.
Why Pair Hammerspoon with UBOS Automation Studio?
UBOS offers a Workflow automation studio that lets you orchestrate cloud‑based tasks, APIs, and AI agents without writing code. By combining Hammerspoon’s local macOS control with UBOS’s cloud workflows, you can create end‑to‑end automations such as:
- Trigger a AI marketing agent to generate a social‑media post whenever you save a new blog draft on your Mac.
- Use the Enterprise AI platform by UBOS to analyze logs collected by a Hammerspoon script and surface anomalies in real time.
- Deploy the Web app editor on UBOS to build a dashboard that visualizes the status of your Hammerspoon‑controlled devices.
This hybrid approach maximizes productivity: local scripts handle UI‑level actions, while UBOS manages data‑centric, AI‑powered processes.
Ready to Supercharge Your macOS?
Whether you’re a developer, designer, or power‑user, Hammerspoon gives you the freedom to script your Mac exactly the way you want. Dive into the official repository, explore the UBOS portfolio examples for inspiration, and start building your first automation today.