Hammerspoon

1.1.1

Thu, 26 Feb 2026 00:00:00 +0000

Minimum macOS version: 13.0

Fixed

Download archive of Hammerspoon should no longer contain spurious resource forks that can confuse macOS Gatekeeper

1.1.0

Wed, 24 Dec 2025 00:00:00 +0000

Minimum macOS version: 13.0

Fixed

hs.task arguments are now validated to all be strings. Closes #2337
Early Lua setup will now create proper package.path entries with expanded tildes. Closes #3518
hs.httpserver:start() now correctly handles websockets. Closes #3468
Internal overrides of Lua’s print() function will no longer cause recursion when using hs.ipc
hs.window.filter now tracks applications by PID rather than by name, preventing issues when multiple apps are running with the same name
Stream Deck Mini v1 button callback is now functional. Closes #3766
Resolved a situation where hs.window:application() could corrupt Lua’s stack after an application had terminated
Resolved a crash where event handlers received an invalid PID after an application had terminated

Changed

hs.urlevent callbacks will now always be sent scheme/host in lowercase. Closes #3686
hs.menubar:setMenu() will no longer always recreate menus, allowing them to be modified while visible. Closes #1923
hs.window:setFrame() is now aware of applications that use “Enhanced UI” features to animate their windows.
hs.mouse.trackingSpeed() can now get/set trackpad speeds. Closes #3744

Added

When acting as the default handler for http/https, Handoff URLs are now supported (PR #3635)
hs.eventtap can now create smart magnify events. Closes #3282
Added hs.audiodevice:thru() / hs.audiodevice:setThru() for monitoring audio from one device to another.

1.0.0

Tue, 06 Aug 2024 00:00:00 +0000

Minimum macOS version: 12.0

Anniversary

This release comes after 100 releases of 0.9, and just two months shy of Hammerspoon’s 10th birthday.

Thank you all for your part in this project, it’s been a lot of fun!

Fixed

Large amounts of Console window history should now consume less RAM and Hammerspoon should no longer hang when large amounts of text are written quickly to the window.
hs.network.ping should now always call the didFinish callback
hs.pasteboard.callbackWhenChanged() now correctly accepts nil for its first argument, as documented
Moving a window to another Space is now fixed in macOS Sonoma
Various typos/grammar/mistakes in docstrings have been fixed

Changed

Lua has been updated to 5.4.7
hs.urlevent callback now receives an extra parameter containing the full original URL
When holding Cmd and Option at startup, the dialog for resetting preferences is now clearer

Added

hs.spotify.getCurrentTrackArtworkURL()
hs.streamdeck now supports the newer hardware variant of the Stream Deck XL

0.9.100

Tue, 14 Mar 2023 00:00:00 +0000

Minimum macOS version: 11.0

Fixed

None

Changed

None

Added

hs.hash now has binary-preserving variants of MD5/SHA1/SHA256/SHA512 (where the existing functions encode the hash to a hex string). These functions have been added to support the new OBS Spoon

0.9.99

Mon, 13 Mar 2023 00:00:00 +0000

Minimum macOS version: 11.0

Fixed

Revert SocketRocket pod update. Closes #3422 #3424
Fix hs.application.get() interpreting Lua patterns #3425

Changed

The default behaviour of hs.application.find() has changed slightly. You may get different results than before, but they should be more correct now.

Added

hs.application.find() now has two additional parameters for controlling how the hint string is interpreted

0.9.98

Sun, 12 Mar 2023 00:00:00 +0000

Minimum macOS version: 11.0

Fixed

hs.image:colorAt() now takes into account scale #3185
Fixed crash in hs.image.getExifFromPath() #3177
Fix hs.spaces so it works when hs.spaces.screensHaveSeparateSpaces() is false #3196
Fix two crash bugs in hs.camera #3211
add DemoPro to SKIP_APPS_TRANSIENT_WINDOWS #3236
Fix bug where window switcher does not go away when caps lock is on #3238
Fix hs.application.get() always returning nil #3216
Fix lua-objc mapping to handle high/low surrogate pairs in hs.styledtext #3356
Spaces now finds Dock instead of Docker #3371
Truncate Console scrollback history #3400
Fix windowHints bugs with utf8 chars #3243
Fix ICMP socket leak in hs.ping #3419

Changed

Allow hs.chooser query to still be forwarded when no matching string exists #3232
Bump minimum requirements to macOS 11.0 #3312
Speed up window switching timers #3237

Added

Added ability to save a hs.menubar position between reloads #3195
Added functions to get application localization information #3191
hs.http must follow redirects #1889 #3279
Added hs.mouse.currentCursorType() #3265
Added hs.serial:rts() and hs.serial:dtr() #3314
feat(spaces): add force arg for moveWindowToSpace #3298
hs.fnutils.reduce takes an optional initial value #3363
Added support for Stream Deck Mini V2 #3378
Added support for Stream Deck Plus #3383
Add hs.streamdeck:imageSize() #3407
Add support for Stream Deck Pedal #3409

0.9.97

Wed, 30 Mar 2022 00:00:00 +0000

Minimum macOS version: 11.0

Core

None

Extensions

Fixed: hs.menubar no longer overlaps images and text, if both are set. Fixes #3171
Fixed: hs.spaces no longer errors if Docker.app is installed. Fixes #3170
Added: hs.menubar:imagePosition()

0.9.96

Mon, 28 Mar 2022 00:00:00 +0000

Minimum macOS version: 10.15

Core

Lua search paths (package.path and package.cpath) have been updated to search in some additional locations

Extensions

Fixed: hs.http connection callbacks should no longer crash in some situations if Lua coroutines are being used.
Fixed: Prevented a possible race condition in hs.webview when fading and deleting an object
Added: hs.webview.toolbar:toolbarStyle()
Added: hs.screen:getInfo() (may be helpful for distinguishing between multiple identical monitors)
Added: Various functions in hs.spaces
Changed: Several macOS SDK deprecations have been adapted to, across multiple modules. Please report any regressions found.

0.9.95

Wed, 09 Mar 2022 00:00:00 +0000

Minimum macOS version: 10.15

Core

None

Extensions

Fixed: hs.camera.isInUse() no longer crashes

0.9.94

Fri, 25 Feb 2022 00:00:00 +0000

Minimum macOS version: 10.15

Core

Default values of package.path/package.cpath should now work with Homebrew luarocks on Apple Silicon

Extensions

Added: hs.razer to support Razer Tartarus V2
Added: hs.image.toASCII()
Added: hs.http.put(), hs.http.asyncPut()
Added: hs.streamdeck now supports the Mk2 model
Added: hs.urlevent.mailtoCallback for handling mailto: URIs
Fixed: hs.audiodevice:setBalance() now works correctly
Fixed: hs.doc.builder can now be loaded again
Fixed: hs.camera.isInUse() now works correctly
Fixed: hs.serial.deviceCallback() should no longer crash in some circumstances
Fixed: hs.mouse should now correctly determine if a pointing device is internal
Fixed: hs.streamdeck now correctly reads serial/firmware information on all models
Changed: hs.processInfo now contains information about CPU architecture and use of Rosetta2
Changed: Attempted to work around a crash in hs.eventtap
Changed: hs.ipc callbacks now limit how many times they can be called recursively, to work around a potential crash
Changed: hs.keycodes now attempts to work around a change in macOS 12 that caused keycodes 93 and 94 to be listed incorrectly