spb/tools-spboucher-ai
Public
1{2 "slug": "hammerspoon",3 "name": "Hammerspoon",4 "aliases": [],5 "vendor": { "name": "Hammerspoon contributors", "slug": "hammerspoon", "website": "https://www.hammerspoon.org/" },6 "homepage_url": "https://www.hammerspoon.org/",7 "docs_url": "https://www.hammerspoon.org/docs/",8 "repo_url": "https://github.com/Hammerspoon/hammerspoon",9 "license_url": "https://github.com/Hammerspoon/hammerspoon/blob/master/LICENSE",10 "product_type": "application",11 "product_status": "active",12 "summary": "Open-source macOS automation app that exposes system APIs to a Lua configuration file for hotkeys, window management and event-driven scripts",13 "description": "Hammerspoon is an open-source macOS automation tool (MIT license) that acts as a bridge between the operating system and an embedded Lua interpreter. It does nothing until the user writes `~/.hammerspoon/init.lua`; from there, Lua code can bind global hotkeys, move and resize windows, react to application, screen, Wi-Fi, USB, battery or filesystem events, draw on-screen overlays, control audio devices, read the clipboard, run shell commands and AppleScript, and expose a menu-bar item or a local URL/IPC endpoint.\n\nThe extension modules are documented API by API, and reusable plug-ins called Spoons package common setups such as window grids or caffeine toggles. Because everything is text, configurations are easy to version-control and share, which appeals to developers who want programmable, keyboard-driven control of their Mac without a GUI macro editor.\n\nIt is distributed as a signed app from GitHub releases (also via Homebrew cask), requires Accessibility permission, and supports recent macOS versions on Intel and Apple Silicon. Limits: Lua is a prerequisite, there is no visual editor, and features depending on private or changing macOS APIs can break between OS releases.",14 "capabilities": ["Global hotkeys and key remapping in Lua", "Window placement and multi-display management", "Watchers for application, screen, Wi-Fi, USB, battery and path events", "Menu-bar items, alerts and on-screen drawing", "Shell, AppleScript and URL-scheme integration", "Reusable Spoon plug-ins"],15 "workflows": ["Tile windows with keyboard shortcuts", "Switch audio output or Wi-Fi settings when a display connects", "Trigger scripts from a URL scheme or another app"],16 "advantages": ["Fully scriptable and version-controllable configuration", "Free and MIT-licensed", "Broad coverage of macOS APIs in one tool"],17 "limitations": ["Requires writing Lua", "No graphical macro editor", "Some modules depend on APIs that change across macOS releases"],18 "prerequisites": ["Recent macOS release", "Accessibility permission for the app"],19 "audiences": ["Developers and power users who prefer code to GUIs", "Keyboard-centric window-management enthusiasts"],20 "alternatives": ["keyboard-maestro", "raycast", "alfred", "karabiner-elements", "applescript"],21 "categories": [{ "slug": "macos-automation", "primary": true }],22 "tags": ["macos", "automation", "lua", "open-source", "window-management", "hotkeys"],23 "use_cases": ["automate-desktop-tasks"],24 "operating_systems": ["macos"],25 "execution_modes": ["local"],26 "interfaces": ["desktop", "library"],27 "deployment_models": ["desktop"],28 "integrations": ["AppleScript", "Shell", "URL schemes", "Homebrew cask"],29 "data_formats": ["Lua scripts"],30 "languages": ["Lua", "Objective-C"],31 "source_model": "open-source",32 "license_spdx": "MIT",33 "pricing_model": ["open-source", "free"],34 "self_hostable": true,35 "sources": [36 { "url": "https://www.hammerspoon.org/", "type": "official_site", "title": "Hammerspoon", "supports": ["name", "summary", "capabilities", "prerequisites"], "checked_at": "2026-11-02" },37 { "url": "https://www.hammerspoon.org/docs/", "type": "official_docs", "title": "Hammerspoon API docs", "supports": ["capabilities"], "checked_at": "2026-11-02" },38 { "url": "https://github.com/Hammerspoon/hammerspoon/blob/master/LICENSE", "type": "license_page", "supports": ["license_spdx", "source_model"], "checked_at": "2026-11-02" }39 ],40 "confidence": "high",41 "discovery_method": "editorial-research",42 "depth": "standard",43 "editorial_status": "reviewed",44 "visibility": "public",45 "featured": false,46 "author": "batch-C"47}48