# Hammerspoon changelog

> Automate macOS with Lua.

- Vendor: Hammerspoon
- Category: Productivity
- Platforms: macOS
- Official site: https://www.hammerspoon.org
- Tracked by: What's New (https://whatsnew.fyi/product/hammerspoon)
- Harvested from: GitHub (Hammerspoon/hammerspoon)
- Entries below: 10 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

## Releases

### 1.1.1

- Date: 2026-02-26
- Version: 1.1.1
- Original notes: https://github.com/Hammerspoon/hammerspoon/releases/tag/1.1.1
- Permalink: https://whatsnew.fyi/product/hammerspoon/releases/1.1.1
- Labels: Platforms: macOS

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

---
layout: post
title: 1.1.1
permalink: /releasenotes/1.1.1.html
---

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

- Date: 2025-12-24
- Version: 1.1.0
- Original notes: https://github.com/Hammerspoon/hammerspoon/releases/tag/1.1.0
- Permalink: https://whatsnew.fyi/product/hammerspoon/releases/1.1.0
- Labels: Platforms: macOS

- **fixed** — Validate that all arguments provided for an hs.task are strings
- **fixed** — Fixes for Xcode 16
- **fixed** — hs.urlevent callback parameters are now lowercase
- **fixed** — Fix package.paths under userruntime with unexpanded tilde
- **fixed** — Fixed websocket support in hs.httpserver:start()
- **fixed** — hs.ipc: Avoid reentrance when in printReplacement
- **fixed** — Fix Lua stack corruption in window:application() when process terminated
- **fixed** — Reuse statusItem menu if possible
- **fixed** — The window_filter event handler might receive an invalid pid
- **fixed** — hs.mouse - fixes setMouseSpeed and adds trackpad support
- **added** — Lua skin additions
- **added** — Add NSUserActivityTypeBrowsingWeb handling
- **added** — Support creation of smart magnify events
- **added** — Add hs.audiodevice:thru() and hs.audiodevice:setThru(thru)
- **added** — Improve window move and resize by managing AXEnhancedUserInterface attribute
- **fixed** — Fixed Stream Deck Mini Button 1 Callback Trigger
- **changed** — window_filter: track applications by PID

##### Fixed

- Validate that all arguments provided for an hs.task, are strings [#3664](https://github.com/Hammerspoon/hammerspoon/pull/3664)
- Fixes for Xcode 16 [#3690](https://github.com/Hammerspoon/hammerspoon/pull/3690)
- hs.urlevent callback parameters are now lowercase [#3691](https://github.com/Hammerspoon/hammerspoon/pull/3691)
- Fix `package.path`s under `userruntime` w/ unexpanded tilde [#3703](https://github.com/Hammerspoon/hammerspoon/pull/3703)
- Fixed websocket support in `hs.httpserver:start()` [#3665](https://github.com/Hammerspoon/hammerspoon/pull/3665)
- hs.ipc: Avoid reentrance when in printReplacement [#3718](https://github.com/Hammerspoon/hammerspoon/pull/3718)
- Fix Lua stack corruption in window:application() when process terminated [#3827](https://github.com/Hammerspoon/hammerspoon/pull/3827)
- Reuse [statusItem menu] if possible (fixes #1923) [#3812](https://github.com/Hammerspoon/hammerspoon/pull/3812)
- The window_filter event handler might receive an invalid pid [#3814](https://github.com/Hammerspoon/hammerspoon/pull/3814)
- hs.mouse - fixes setMouseSpeed and adds trackpad support [#3758](https://github.com/Hammerspoon/hammerspoon/pull/3758)

##### Added

- Lua skin additions [#3667](https://github.com/Hammerspoon/hammerspoon/pull/3667)
- Add NSUserActivityTypeBrowsingWeb handling [#3635](https://github.com/Hammerspoon/hammerspoon/pull/3635)
- Support creation of smart magnify events [#3679](https://github.com/Hammerspoon/hammerspoon/pull/3679)
- Add hs.audiodevice:thru() and hs.audiodevice:setThru(thru) [#3716](https://github.com/Hammerspoon/hammerspoon/pull/3716)
- Improve window move and resize by managing AXEnhancedUserInterface attribute [#3836](https://github.com/Hammerspoon/hammerspoon/pull/3836)
- hs.mouse - fixes setMouseSpeed and adds trackpad support [#3758](https://github.com/Hammerspoon/hammerspoon/pull/3758)


##### Other

- window_filter: track applications by PID [#3745](https://github.com/Hammerspoon/hammerspoon/pull/3745)
- Fixed Stream Deck Mini Button 1 Callback Trigger [#3767](https://github.com/Hammerspoon/hammerspoon/pull/3767)
- Update copyrights. [#3804](https://github.com/Hammerspoon/hammerspoon/pull/3804)
- Actually create a proper PR for build fixes [#3834](https://github.com/Hammerspoon/hammerspoon/pull/3834)
- Fix typo in logger's documentation [#3778](https://github.com/Hammerspoon/hammerspoon/pull/3778)

### 1.0.0

- Date: 2024-08-06
- Version: 1.0.0
- Original notes: https://github.com/Hammerspoon/hammerspoon/releases/tag/1.0.0
- Permalink: https://whatsnew.fyi/product/hammerspoon/releases/1.0.0
- Labels: Platforms: macOS

##### Fixed

- [READY] hs.battery -- Fix for systems that report an empty array for powerSources [#3449](https://github.com/Hammerspoon/hammerspoon/pull/3449)
- add exit call to fix empty space issue #3465 [#3466](https://github.com/Hammerspoon/hammerspoon/pull/3466)
- Include docs.css in build for built in web help [#3476](https://github.com/Hammerspoon/hammerspoon/pull/3476)
- fix `attempt to index a nil value (local 'child')` #3481  [#3485](https://github.com/Hammerspoon/hammerspoon/pull/3485)
- Fix hs.network.ping to always call didFinish callback [#3531](https://github.com/Hammerspoon/hammerspoon/pull/3531)
- Allow passing nil as name to hs.pasteboard.callbackWhenChanged [#3616](https://github.com/Hammerspoon/hammerspoon/pull/3616)
- [Review] Fix moving window to space in Sonoma 14.5 [#3638](https://github.com/Hammerspoon/hammerspoon/pull/3638)
- Improve Console window performance and RAM usage [#3659](https://github.com/Hammerspoon/hammerspoon/pull/3659)

##### Changed

- Fix blockAlert documentation [#3484](https://github.com/Hammerspoon/hammerspoon/pull/3484)
- Rewrite of hs.hash to simplify adding new hashes [#3483](https://github.com/Hammerspoon/hammerspoon/pull/3483)

##### Added

- [Ready] hs.watchable -- added alwaysNotify to watcher [#3440](https://github.com/Hammerspoon/hammerspoon/pull/3440)
- Update alert.lua: allow window object as parameter [#3542](https://github.com/Hammerspoon/hammerspoon/pull/3542)
- Add getCurrentTrackArtworkURL() to spotify extension [#3546](https://github.com/Hammerspoon/hammerspoon/pull/3546)
- Added new Stream Deck XL PID [#3570](https://github.com/Hammerspoon/hammerspoon/pull/3570)
- Pass in `fullURL` to url event callback handler [#3640](https://github.com/Hammerspoon/hammerspoon/pull/3640)
- Improve preferences resetting dialog [#3657](https://github.com/Hammerspoon/hammerspoon/pull/3657)
- Update Lua to 5.4.7 [#3658](https://github.com/Hammerspoon/hammerspoon/pull/3658)


##### Other

- fix(ci): Manage secrets/permissions [#3396](https://github.com/Hammerspoon/hammerspoon/pull/3396)

### 0.9.100

- Date: 2023-03-14
- Version: 0.9.100
- Original notes: https://github.com/Hammerspoon/hammerspoon/releases/tag/0.9.100
- Permalink: https://whatsnew.fyi/product/hammerspoon/releases/0.9.100
- Labels: Platforms: macOS

---
layout: post
title: 0.9.100
permalink: /releasenotes/0.9.100.html
---

##### 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](https://www.hammerspoon.org/Spoons/OBS.html)

### 0.9.99

- Date: 2023-03-13
- Version: 0.9.99
- Original notes: https://github.com/Hammerspoon/hammerspoon/releases/tag/0.9.99
- Permalink: https://whatsnew.fyi/product/hammerspoon/releases/0.9.99
- Labels: Platforms: macOS

##### Fixed

- Revert SocketRocket pod update. Closes #3422 [#3424](https://github.com/Hammerspoon/hammerspoon/pull/3424)
- Fix hs.application.get() interpreting Lua patterns [#3425](https://github.com/Hammerspoon/hammerspoon/pull/3425)


##### Other

### 0.9.98

- Date: 2023-03-12
- Version: 0.9.98
- Original notes: https://github.com/Hammerspoon/hammerspoon/releases/tag/0.9.98
- Permalink: https://whatsnew.fyi/product/hammerspoon/releases/0.9.98
- Labels: Platforms: macOS

##### Fixed

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

##### Changed

- Allow hs.chooser query to still be forwarded when no matching string exists [#3232](https://github.com/Hammerspoon/hammerspoon/pull/3232)
- Bump minimum requirements to macOS 11.0 [#3312](https://github.com/Hammerspoon/hammerspoon/pull/3312)
- Speed up window switching timers [#3237](https://github.com/Hammerspoon/hammerspoon/pull/3237)

##### Added

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


##### Other

### 0.9.97

- Date: 2022-03-30
- Version: 0.9.97
- Original notes: https://github.com/Hammerspoon/hammerspoon/releases/tag/0.9.97
- Permalink: https://whatsnew.fyi/product/hammerspoon/releases/0.9.97
- Labels: Platforms: macOS

---
layout: post
title: 0.9.97
permalink: /releasenotes/0.9.97.html
---

##### 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

- Date: 2022-03-28
- Version: 0.9.96
- Original notes: https://github.com/Hammerspoon/hammerspoon/releases/tag/0.9.96
- Permalink: https://whatsnew.fyi/product/hammerspoon/releases/0.9.96
- Labels: Platforms: macOS

- None

### 0.9.95

- Date: 2022-03-09
- Version: 0.9.95
- Original notes: https://github.com/Hammerspoon/hammerspoon/releases/tag/0.9.95
- Permalink: https://whatsnew.fyi/product/hammerspoon/releases/0.9.95
- Labels: Platforms: macOS

- None

### 0.9.94

- Date: 2022-02-25
- Version: 0.9.94
- Original notes: https://github.com/Hammerspoon/hammerspoon/releases/tag/0.9.94
- Permalink: https://whatsnew.fyi/product/hammerspoon/releases/0.9.94
- Labels: Platforms: macOS

- None