SPB Git
4.2 KB · 48 lines json
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
Files · main
Menu

Theme