Repository navigation
Releases
Fix Mission Control clicks on other desktops
Fix MissionControlSend Shift-clicks that only focused a window on another desktop. macOS can report an invisible thumbnail from a different desktop under the pointer; the Spoon now resolves the sole visible thumbnail on the active desktop while rejecting ambiguous overlaps.
Verified a physical Shift-click moving Claude from Desktop 2 to Desktop 1. Regression checks cover the hidden-thumbnail case, wraparound, overlapping thumbnails, and unrelated displays/processes. All Lua checks and the ZIP privacy audit passed.
Includes all seven current Spoon packages. AirPodsMeet’s voice clips retain their separate noncommercial attribution terms.
Shift-click windows to the next desktop
MissionControlSend adds Shift-click in Mission Control to move a window to the next ordinary desktop, with wraparound. Release Shift after clicking; the Spoon performs the drag and verifies the destination.
The README now includes a preview, use case, setup, and download link. The SpoonInstall catalog includes the new package. This experimental feature has been tested with a physical click on macOS 27.2.1; ambiguous windows are skipped.
All seven current Spoon packages are included. All Lua checks and the package privacy check passed. AirPodsMeet’s voice clips retain their separate noncommercial attribution terms.
KSheet shortcuts with Escape dismissal
KSheet shows the current app’s native menu shortcuts with Control–Option–Command–K. Press Escape or the shortcut again to close it.
This fork preserves ashfinal’s upstream KSheet attribution and Dharma Poudel’s layout credit. It adds Escape dismissal, local CSS in place of the external layout script, and escaped app/menu labels. The README includes a preview and setup guide.
All six current Spoon packages are included. No personal configuration or captured menus are packaged. AirPodsMeet’s voice clips retain their separate noncommercial attribution terms.
Validation: all Lua checks passed; a synthetic menu rendered in Hammerspoon with the offline layout and Escape dismissal; the source and ZIP passed privacy checks.
Torrent downloads with category selection
Download a torrent on your Mac, choose an existing category, and send it to your qBittorrent server. TorrentToQbit watches new downloads, checks for duplicates, and verifies uploads.
Keep your server address and login in a separate private config file; neither is included in these packages. The README now includes a preview and setup guide for TorrentToQbit.
This release includes the current packages for all five Spoons. AirPodsMeet’s bundled voice clips have separate noncommercial attribution terms; see its audio license.
Validation: all Lua checks passed, source and ZIP privacy checks passed, and a real torrent upload with category selection was confirmed.
Automatic clipboard attachments and clearer guides
PasteToPicker 1.1.0 now completes the native file picker automatically. Press Control–Option–Command–V with a clipboard image: it selects the temporary PNG, presses the enabled Open/Upload button once, and waits for the dialog to close.
Accepting the picker may start an upload through the destination app. A separate Send or Publish button is not pressed. Failed confirmation, a disabled button, a dialog that remains open, or changing apps stops the operation without repeated submissions.
The repository README and each Spoon's guide now explain practical use cases and provide walkthroughs. PersonalSafari and SafariTabGroups code is unchanged; their downloads include the expanded documentation.
Validation: all included automated checks pass, including 12 PasteToPicker scenarios. Automatic confirmation was also verified in a real Safari upload picker: the dialog closed and the image attached successfully.
Consistent shortcut modifiers
PasteToPicker 1.0.3 now uses Control–Option–Command–V by default, matching the modifier keys used by the other Spoons.
- Adds
defaultHotkeysfor SpoonInstall and a no-argumentbindHotkeys()default. - Keeps explicit custom shortcut mappings supported.
- Updates setup examples and the installable package.
PersonalSafari 1.0.2 and SafariTabGroups 1.0.0 are unchanged. All included Lua checks pass. Existing users with an explicit binding should add alt to that mapping or call bindHotkeys() without arguments.
Spoons: first public release
Initial public collection of three Hammerspoon Spoons:
- SafariTabGroups 1.0.0 — searchable tab-group chooser for the current Safari window.
- PersonalSafari 1.0.2 — Shift-click links into a chosen Safari window across desktops.
- PasteToPicker 1.0.2 — select a clipboard image in a native file picker, leaving final upload confirmation to the user.
Each ZIP installs independently. See the repository README for shortcuts and SpoonInstall setup.
This distribution contains reusable code, synthetic tests and documentation. Personal configuration, settings, diagnostic captures, clipboard images and upstream KSheet are excluded. The clipboard window-content debug helper is omitted. All included Lua checks pass.
SHA256SUMS contains checksums for the three ZIP assets.