[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"package:cask:hammerspoon:en":3,"releases:stats:cask:hammerspoon:en":490,"related:cask:hammerspoon:en":491,"markdown:3:4435:1hwpont":545},{"accentColor":4,"artifacts":5,"autoUpdates":46,"categories":47,"conflictsWith":54,"dependsOn":57,"deprecated":50,"description":68,"descriptionEn":69,"developer":70,"disabled":50,"displayName":71,"downloadSha256":72,"downloadSize":73,"downloadUrl":74,"editorChoice":50,"formulaeUrl":75,"homepage":76,"iconUrl":77,"installCommand":78,"installs":79,"installs30d":80,"isFont":50,"isLibrary":50,"kegOnly":50,"kind":83,"latestRelease":84,"machineTranslated":50,"minMacos":67,"name":71,"names":103,"platforms":105,"primaryCategory":470,"rank30d":471,"releaseCount":472,"releaseStats":473,"repoUrl":478,"screenshots":479,"sourceLocale":97,"sourceUrl":480,"summary":481,"summaryTranslation":482,"supports":483,"tags":485,"tap":489,"token":104,"version":102,"versionChangedAt":88},"#FBAB1D",{"apps":6,"binaries":8,"entries":10,"pkgs":45},[7],"Hammerspoon.app",[9],"hs",[11,18,25,32],{"declaration":12,"phase":16,"sources":17,"type":16},{"uninstall":13},[14],{"quit":15},"org.hammerspoon.Hammerspoon","uninstall",[],{"declaration":19,"phase":22,"sources":23,"target":21,"type":24},{"app":20,"target":21},[7],"\u002FApplications\u002FHammerspoon.app","install",[7],"app",{"declaration":26,"phase":22,"sources":30,"target":29,"type":31},{"binary":27,"target":29},[28],"$APPDIR\u002FHammerspoon.app\u002FContents\u002FFrameworks\u002Fhs\u002Fhs","$HOMEBREW_PREFIX\u002Fbin\u002Fhs",[28],"binary",{"declaration":33,"phase":42,"sources":43,"type":44},{"zap":34},[35],{"trash":36},[37,38,39,40,41],"~\u002F.hammerspoon","~\u002FLibrary\u002FApplication Support\u002Fcom.crashlytics\u002Forg.hammerspoon.Hammerspoon","~\u002FLibrary\u002FCaches\u002Forg.hammerspoon.Hammerspoon","~\u002FLibrary\u002FPreferences\u002Forg.hammerspoon.Hammerspoon.plist","~\u002FLibrary\u002FSaved Application State\u002Forg.hammerspoon.Hammerspoon.savedState","cleanup",[],"zap",[],true,[48],{"icon":49,"machineTranslated":50,"name":51,"slug":52,"sourceLocale":53},"lucide:wrench",false,"Utilities","utilities","zh-CN",{"casks":55,"formulae":56},[],[],{"arch":58,"casks":61,"formulae":62,"macos":63,"requirements":64},[59,60],"arm64","x86_64",[],[],">= 13",{"macos":65},{">=":66},[67],"13","Hammerspoon is a macOS desktop automation application that bridges a Lua scripting engine to system APIs. It is aimed at people comfortable writing small scripts who want personalized keyboard shortcuts, window workflows and event-driven automation. Installing it alone does not supply a finished set of automations: behavior comes from your configuration.\n\n## Capabilities\n- Bind hotkeys and automate window positioning, application actions and desktop workflows.\n- Respond to screen, network, power and other system events with Lua callbacks.\n- Inspect and control supported audio devices, clipboard and input behavior.\n- Display notifications, menus and custom interfaces through the available APIs.\n- Integrate shell tasks, AppleScript and supported application\u002Fsystem extensions.\n- Install optional reusable Lua plugins called Spoons; each Spoon has its own setup and dependencies.\n\n## Install and configure\nInstall `brew install --cask hammerspoon`, or download the official ZIP, extract it and move Hammerspoon.app to Applications. Launch it and create `~\u002F.hammerspoon\u002Finit.lua`. Use its menu to edit and reload the configuration; inspect the Console for errors and interactive Lua experiments. A simple starting configuration can bind a hotkey to a notification, then grow into window or application automation. The official Getting Started guide and API documentation provide working examples.\n\nGrant Hammerspoon Accessibility access in macOS System Settings when automating desktop applications or input. Additional operations can require their own system permissions, such as Automation or Screen Recording. Only enable the permissions your configuration needs. Scripts and Spoons execute with your user's capabilities; review code before installing it.\n\nThe cask also links the bundled `hs` command-line tool. Command-line communication is configured through Hammerspoon's IPC module; the link alone does not enable every IPC feature.\n\n## Systems and dependencies\nThe current1.1.1 release and Homebrew Cask require macOS13 or later. The Cask lists Intel and Apple Silicon Mac platforms. Hammerspoon is Mac-specific; its macOS API integrations are not supplied as Windows, Linux, iOS or Android clients. Requirements of older releases should not be substituted for1.1.1. No fixed RAM or disk minimum is specified in the official material reviewed.\n\nThe official1.1.1 ZIP is9,704,557 bytes according to its GitHub release-asset metadata. Installed application, scripts and caches occupy additional space. Lua and the application's extensions are bundled; the cask declares no extra formula dependency and no explicit cask conflict. Xcode and build tools are needed to compile the source, not to use the release app. Optional Spoons, shell commands and integrations can require separately installed tools or service accounts.\n\nCustom hotkeys and window automation can overlap with shortcuts or window managers configured elsewhere. Such interactions are configuration-dependent, not a declared package conflict. Disable or adjust duplicate bindings where necessary. OS changes and target-application accessibility behavior can affect individual automation APIs.\n\n## Data, accounts, cost and license\nCore local automation does not require a Hammerspoon account or subscription. The project is free and MIT-licensed, permitting use and modification including commercial use subject to retaining required notices. Bundled libraries and optional Spoons retain their respective licenses; hosted services invoked by your scripts can have separate costs and accounts. The official FAQ says crash reporting is enabled by default and can be disabled in Preferences; review the project's privacy policy.\n\nHomebrew zap includes `~\u002F.hammerspoon`, application preferences, caches and saved state. That configuration directory contains your custom Lua scripts and Spoons, so back it up before deep cleanup. Removing the app does not undo every external action performed by your scripts or delete accounts used by integrations.\n\n## Official references\n- Product: https:\u002F\u002Fwww.hammerspoon.org\u002F\n- Getting Started: https:\u002F\u002Fwww.hammerspoon.org\u002Fgo\u002F\n- API documentation: https:\u002F\u002Fwww.hammerspoon.org\u002Fdocs\u002F\n- FAQ and privacy: https:\u002F\u002Fwww.hammerspoon.org\u002Ffaq\u002F and https:\u002F\u002Fwww.hammerspoon.org\u002Fprivacy.html\n- Source, MIT license and releases: https:\u002F\u002Fgithub.com\u002FHammerspoon\u002Fhammerspoon\n- Official Spoon repository: https:\u002F\u002Fgithub.com\u002FHammerspoon\u002FSpoons\n","Desktop automation application","Hammerspoon contributors","Hammerspoon","11bb1c90faf5427f37c7bd4fe7eab9774ae43e1d5cb020c5b3088dac32849efa",9704557,"https:\u002F\u002Fgithub.com\u002FHammerspoon\u002Fhammerspoon\u002Freleases\u002Fdownload\u002F1.1.1\u002FHammerspoon-1.1.1.zip","https:\u002F\u002Fformulae.brew.sh\u002Fcask\u002Fhammerspoon","https:\u002F\u002Fwww.hammerspoon.org\u002F","https:\u002F\u002Fcdn.opennavo.com\u002Ficons\u002Fuploads\u002Fc783517bbc3e\u002F321bed83a25f-256.png","brew install --cask hammerspoon",{"d30":80,"d365":81,"d90":82},3597,51896,14776,"cask",{"bodyMarkdown":85,"brewCommittedAt":86,"hasNotes":46,"id":87,"isLatest":46,"isPrerelease":50,"machineTranslated":50,"publishedAt":88,"sections":89,"source":96,"sourceLocale":97,"summary":98,"title":99,"translation":100,"version":102},"# Hammerspoon 1.1.1\n\nCorrects the release archive so unexpected resource forks no longer interfere with macOS Gatekeeper; requires macOS13+.\n\n## Packaging\n\n- Removes unintended resource forks from the downloadable archive.\n- Prevents archive metadata from confusing macOS Gatekeeper.\n- Official release lists macOS13.0 as the minimum.\n\n[Official version-specific release](https:\u002F\u002Fgithub.com\u002FHammerspoon\u002Fhammerspoon\u002Freleases\u002Ftag\u002F1.1.1). This editorial summary covers the recorded version; source PR links and implementation details are available in the publisher’s release entry.\n","2026-02-26T13:10:49Z",548,"2026-10-07T09:38:36.653349Z",[90],{"area":91,"items":92},"Packaging",[93,94,95],"Removes unintended resource forks from the downloadable archive.","Prevents archive metadata from confusing macOS Gatekeeper.","Official release lists macOS13.0 as the minimum.","editorial","en-US","Corrects the release archive so unexpected resource forks no longer interfere with macOS Gatekeeper; requires macOS13+.","Hammerspoon 1.1.1",{"locale":97,"machineTranslated":50,"sourceLocale":97,"status":101},"source","1.1.1",[71,104],"hammerspoon",[106,143,179,216,252,289,325,362,398,434],{"arch":60,"artifacts":107,"conflictsWith":131,"dependsOn":134,"downloadSha256":72,"downloadUrl":74,"macos":141,"minMacos":67,"requiresRosetta":50,"tag":142,"version":102},{"apps":108,"binaries":109,"entries":110,"pkgs":130},[7],[9],[111,116,120,124],{"declaration":112,"phase":16,"sources":115,"type":16},{"uninstall":113},[114],{"quit":15},[],{"declaration":117,"phase":22,"sources":119,"target":21,"type":24},{"app":118,"target":21},[7],[7],{"declaration":121,"phase":22,"sources":123,"target":29,"type":31},{"binary":122,"target":29},[28],[28],{"declaration":125,"phase":42,"sources":129,"type":44},{"zap":126},[127],{"trash":128},[37,38,39,40,41],[],[],{"casks":132,"formulae":133},[],[],{"arch":135,"casks":136,"formulae":137,"macos":63,"requirements":138},[60],[],[],{"macos":139},{">=":140},[67],"27","golden_gate",{"arch":59,"artifacts":144,"conflictsWith":168,"dependsOn":171,"downloadSha256":72,"downloadUrl":74,"macos":141,"minMacos":67,"requiresRosetta":50,"tag":178,"version":102},{"apps":145,"binaries":146,"entries":147,"pkgs":167},[7],[9],[148,153,157,161],{"declaration":149,"phase":16,"sources":152,"type":16},{"uninstall":150},[151],{"quit":15},[],{"declaration":154,"phase":22,"sources":156,"target":21,"type":24},{"app":155,"target":21},[7],[7],{"declaration":158,"phase":22,"sources":160,"target":29,"type":31},{"binary":159,"target":29},[28],[28],{"declaration":162,"phase":42,"sources":166,"type":44},{"zap":163},[164],{"trash":165},[37,38,39,40,41],[],[],{"casks":169,"formulae":170},[],[],{"arch":172,"casks":173,"formulae":174,"macos":63,"requirements":175},[59],[],[],{"macos":176},{">=":177},[67],"arm64_golden_gate",{"arch":60,"artifacts":180,"conflictsWith":204,"dependsOn":207,"downloadSha256":72,"downloadUrl":74,"macos":214,"minMacos":67,"requiresRosetta":50,"tag":215,"version":102},{"apps":181,"binaries":182,"entries":183,"pkgs":203},[7],[9],[184,189,193,197],{"declaration":185,"phase":16,"sources":188,"type":16},{"uninstall":186},[187],{"quit":15},[],{"declaration":190,"phase":22,"sources":192,"target":21,"type":24},{"app":191,"target":21},[7],[7],{"declaration":194,"phase":22,"sources":196,"target":29,"type":31},{"binary":195,"target":29},[28],[28],{"declaration":198,"phase":42,"sources":202,"type":44},{"zap":199},[200],{"trash":201},[37,38,39,40,41],[],[],{"casks":205,"formulae":206},[],[],{"arch":208,"casks":209,"formulae":210,"macos":63,"requirements":211},[60],[],[],{"macos":212},{">=":213},[67],"26","tahoe",{"arch":59,"artifacts":217,"conflictsWith":241,"dependsOn":244,"downloadSha256":72,"downloadUrl":74,"macos":214,"minMacos":67,"requiresRosetta":50,"tag":251,"version":102},{"apps":218,"binaries":219,"entries":220,"pkgs":240},[7],[9],[221,226,230,234],{"declaration":222,"phase":16,"sources":225,"type":16},{"uninstall":223},[224],{"quit":15},[],{"declaration":227,"phase":22,"sources":229,"target":21,"type":24},{"app":228,"target":21},[7],[7],{"declaration":231,"phase":22,"sources":233,"target":29,"type":31},{"binary":232,"target":29},[28],[28],{"declaration":235,"phase":42,"sources":239,"type":44},{"zap":236},[237],{"trash":238},[37,38,39,40,41],[],[],{"casks":242,"formulae":243},[],[],{"arch":245,"casks":246,"formulae":247,"macos":63,"requirements":248},[59],[],[],{"macos":249},{">=":250},[67],"arm64_tahoe",{"arch":60,"artifacts":253,"conflictsWith":277,"dependsOn":280,"downloadSha256":72,"downloadUrl":74,"macos":287,"minMacos":67,"requiresRosetta":50,"tag":288,"version":102},{"apps":254,"binaries":255,"entries":256,"pkgs":276},[7],[9],[257,262,266,270],{"declaration":258,"phase":16,"sources":261,"type":16},{"uninstall":259},[260],{"quit":15},[],{"declaration":263,"phase":22,"sources":265,"target":21,"type":24},{"app":264,"target":21},[7],[7],{"declaration":267,"phase":22,"sources":269,"target":29,"type":31},{"binary":268,"target":29},[28],[28],{"declaration":271,"phase":42,"sources":275,"type":44},{"zap":272},[273],{"trash":274},[37,38,39,40,41],[],[],{"casks":278,"formulae":279},[],[],{"arch":281,"casks":282,"formulae":283,"macos":63,"requirements":284},[60],[],[],{"macos":285},{">=":286},[67],"15","sequoia",{"arch":59,"artifacts":290,"conflictsWith":314,"dependsOn":317,"downloadSha256":72,"downloadUrl":74,"macos":287,"minMacos":67,"requiresRosetta":50,"tag":324,"version":102},{"apps":291,"binaries":292,"entries":293,"pkgs":313},[7],[9],[294,299,303,307],{"declaration":295,"phase":16,"sources":298,"type":16},{"uninstall":296},[297],{"quit":15},[],{"declaration":300,"phase":22,"sources":302,"target":21,"type":24},{"app":301,"target":21},[7],[7],{"declaration":304,"phase":22,"sources":306,"target":29,"type":31},{"binary":305,"target":29},[28],[28],{"declaration":308,"phase":42,"sources":312,"type":44},{"zap":309},[310],{"trash":311},[37,38,39,40,41],[],[],{"casks":315,"formulae":316},[],[],{"arch":318,"casks":319,"formulae":320,"macos":63,"requirements":321},[59],[],[],{"macos":322},{">=":323},[67],"arm64_sequoia",{"arch":60,"artifacts":326,"conflictsWith":350,"dependsOn":353,"downloadSha256":72,"downloadUrl":74,"macos":360,"minMacos":67,"requiresRosetta":50,"tag":361,"version":102},{"apps":327,"binaries":328,"entries":329,"pkgs":349},[7],[9],[330,335,339,343],{"declaration":331,"phase":16,"sources":334,"type":16},{"uninstall":332},[333],{"quit":15},[],{"declaration":336,"phase":22,"sources":338,"target":21,"type":24},{"app":337,"target":21},[7],[7],{"declaration":340,"phase":22,"sources":342,"target":29,"type":31},{"binary":341,"target":29},[28],[28],{"declaration":344,"phase":42,"sources":348,"type":44},{"zap":345},[346],{"trash":347},[37,38,39,40,41],[],[],{"casks":351,"formulae":352},[],[],{"arch":354,"casks":355,"formulae":356,"macos":63,"requirements":357},[60],[],[],{"macos":358},{">=":359},[67],"14","sonoma",{"arch":59,"artifacts":363,"conflictsWith":387,"dependsOn":390,"downloadSha256":72,"downloadUrl":74,"macos":360,"minMacos":67,"requiresRosetta":50,"tag":397,"version":102},{"apps":364,"binaries":365,"entries":366,"pkgs":386},[7],[9],[367,372,376,380],{"declaration":368,"phase":16,"sources":371,"type":16},{"uninstall":369},[370],{"quit":15},[],{"declaration":373,"phase":22,"sources":375,"target":21,"type":24},{"app":374,"target":21},[7],[7],{"declaration":377,"phase":22,"sources":379,"target":29,"type":31},{"binary":378,"target":29},[28],[28],{"declaration":381,"phase":42,"sources":385,"type":44},{"zap":382},[383],{"trash":384},[37,38,39,40,41],[],[],{"casks":388,"formulae":389},[],[],{"arch":391,"casks":392,"formulae":393,"macos":63,"requirements":394},[59],[],[],{"macos":395},{">=":396},[67],"arm64_sonoma",{"arch":60,"artifacts":399,"conflictsWith":423,"dependsOn":426,"downloadSha256":72,"downloadUrl":74,"macos":67,"minMacos":67,"requiresRosetta":50,"tag":433,"version":102},{"apps":400,"binaries":401,"entries":402,"pkgs":422},[7],[9],[403,408,412,416],{"declaration":404,"phase":16,"sources":407,"type":16},{"uninstall":405},[406],{"quit":15},[],{"declaration":409,"phase":22,"sources":411,"target":21,"type":24},{"app":410,"target":21},[7],[7],{"declaration":413,"phase":22,"sources":415,"target":29,"type":31},{"binary":414,"target":29},[28],[28],{"declaration":417,"phase":42,"sources":421,"type":44},{"zap":418},[419],{"trash":420},[37,38,39,40,41],[],[],{"casks":424,"formulae":425},[],[],{"arch":427,"casks":428,"formulae":429,"macos":63,"requirements":430},[60],[],[],{"macos":431},{">=":432},[67],"ventura",{"arch":59,"artifacts":435,"conflictsWith":459,"dependsOn":462,"downloadSha256":72,"downloadUrl":74,"macos":67,"minMacos":67,"requiresRosetta":50,"tag":469,"version":102},{"apps":436,"binaries":437,"entries":438,"pkgs":458},[7],[9],[439,444,448,452],{"declaration":440,"phase":16,"sources":443,"type":16},{"uninstall":441},[442],{"quit":15},[],{"declaration":445,"phase":22,"sources":447,"target":21,"type":24},{"app":446,"target":21},[7],[7],{"declaration":449,"phase":22,"sources":451,"target":29,"type":31},{"binary":450,"target":29},[28],[28],{"declaration":453,"phase":42,"sources":457,"type":44},{"zap":454},[455],{"trash":456},[37,38,39,40,41],[],[],{"casks":460,"formulae":461},[],[],{"arch":463,"casks":464,"formulae":465,"macos":63,"requirements":466},[59],[],[],{"macos":467},{">=":468},[67],"arm64_ventura",{"icon":49,"machineTranslated":50,"name":51,"slug":52,"sourceLocale":53},55,3,{"brewLag":474,"cadence":477,"count30d":475},{"compared":472,"earlierCount":475,"medianMinutes":476},1,153722867,"irregular","https:\u002F\u002Fgithub.com\u002FHammerspoon\u002Fhammerspoon",[],"https:\u002F\u002Fgithub.com\u002Fhomebrew\u002Fhomebrew-cask\u002Fblob\u002FHEAD\u002FCasks\u002Fh\u002Fhammerspoon.rb","Free, MIT-licensed macOS automation through Lua scripts, hotkeys, window control, system events and optional reusable Spoons.",{"locale":97,"machineTranslated":50,"sourceLocale":97,"status":101},{"arm64":46,"requiresRosetta":50,"status":484,"x86_64":46},"known",[71,486,487,488],"Lua","Spoons","MIT","homebrew\u002Fcask",null,[492,504,515,525,535],{"accentColor":493,"autoUpdates":46,"deprecated":50,"disabled":50,"displayName":494,"editorChoice":50,"iconUrl":495,"installs30d":496,"isFont":50,"isLibrary":50,"kind":83,"machineTranslated":50,"name":497,"primaryCategory":498,"rank30d":499,"sourceLocale":97,"summary":500,"token":501,"version":502,"versionChangedAt":503},"#4E476E","Karabiner-Elements","https:\u002F\u002Fcdn.opennavo.com\u002Ficons\u002Fuploads\u002F0f84cf748365\u002F262bb536fb3b-256.png",2761,"Karabiner Elements",{"icon":49,"machineTranslated":50,"name":51,"slug":52,"sourceLocale":53},71,"Free macOS keyboard customizer for simple remaps, conditional complex rules, device-specific mappings and input-event inspection.","karabiner-elements","16.3.0","2026-10-07T09:38:37.849603Z",{"accentColor":505,"autoUpdates":50,"deprecated":50,"disabled":50,"displayName":506,"editorChoice":50,"iconUrl":507,"installs30d":508,"isFont":50,"isLibrary":50,"kind":83,"machineTranslated":50,"name":509,"primaryCategory":510,"rank30d":511,"sourceLocale":97,"summary":512,"token":513,"version":514,"versionChangedAt":88},"#FBB346","Homebrew (BrewUI)","https:\u002F\u002Fcdn.opennavo.com\u002Ficons\u002Fuploads\u002F8389ec6e95b5\u002Feed40c5f9fb2-256.png",6634,"Homebrew",{"icon":49,"machineTranslated":50,"name":51,"slug":52,"sourceLocale":53},31,"Homebrew’s official native Mac interface for discovering packages, viewing installed software, upgrading packages and inspecting command output.","homebrew-app","0.5.0",{"accentColor":516,"autoUpdates":46,"deprecated":50,"disabled":50,"displayName":517,"editorChoice":50,"iconUrl":518,"installs30d":519,"isFont":50,"isLibrary":50,"kind":83,"machineTranslated":50,"name":517,"primaryCategory":520,"rank30d":521,"sourceLocale":97,"summary":522,"token":523,"version":524,"versionChangedAt":503},"#4789DB","LinearMouse","https:\u002F\u002Fcdn.opennavo.com\u002Ficons\u002Fuploads\u002F46d5b4315178\u002Fd0174388bf37-256.png",2707,{"icon":49,"machineTranslated":50,"name":51,"slug":52,"sourceLocale":53},73,"Free Mac mouse and trackpad utility for scrolling, pointer acceleration\u002Fspeed, button actions and per-device or app profiles.","linearmouse","0.12.0",{"autoUpdates":46,"deprecated":50,"disabled":50,"displayName":526,"editorChoice":50,"installs30d":527,"isFont":50,"isLibrary":50,"kind":83,"machineTranslated":50,"name":528,"primaryCategory":529,"rank30d":530,"sourceLocale":97,"summary":531,"token":532,"version":533,"versionChangedAt":534},"AppCleaner",2523,"FreeMacSoft AppCleaner",{"icon":49,"machineTranslated":50,"name":51,"slug":52,"sourceLocale":53},80,"Mac uninstall utility that finds associated app files and lets you review what to remove.","appcleaner","3.7","2026-10-07T09:38:25.801627Z",{"accentColor":536,"autoUpdates":46,"deprecated":50,"disabled":50,"displayName":537,"editorChoice":50,"iconUrl":538,"installs30d":539,"isFont":50,"isLibrary":50,"kind":83,"machineTranslated":50,"name":537,"primaryCategory":540,"rank30d":541,"sourceLocale":97,"summary":542,"token":543,"version":544,"versionChangedAt":534},"#7489E6","BetterDisplay","https:\u002F\u002Fcdn.opennavo.com\u002Ficons\u002Fuploads\u002Fc8ab5c259e1f\u002F872d50d0c7af-256.png",5276,{"icon":49,"machineTranslated":50,"name":51,"slug":52,"sourceLocale":53},37,"Mac display controls for brightness, resolution and monitor arrangement, with paid Pro features for HiDPI scaling, image adjustments, virtual screens and streaming.","betterdisplay","5.1.1","\u003Cp>Hammerspoon is a macOS desktop automation application that bridges a Lua scripting engine to system APIs. It is aimed at people comfortable writing small scripts who want personalized keyboard shortcuts, window workflows and event-driven automation. Installing it alone does not supply a finished set of automations: behavior comes from your configuration.\u003C\u002Fp>\n\u003Ch3 class=\"on-md-heading-1\">Capabilities\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Bind hotkeys and automate window positioning, application actions and desktop workflows.\u003C\u002Fli>\n\u003Cli>Respond to screen, network, power and other system events with Lua callbacks.\u003C\u002Fli>\n\u003Cli>Inspect and control supported audio devices, clipboard and input behavior.\u003C\u002Fli>\n\u003Cli>Display notifications, menus and custom interfaces through the available APIs.\u003C\u002Fli>\n\u003Cli>Integrate shell tasks, AppleScript and supported application\u002Fsystem extensions.\u003C\u002Fli>\n\u003Cli>Install optional reusable Lua plugins called Spoons; each Spoon has its own setup and dependencies.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3 class=\"on-md-heading-1\">Install and configure\u003C\u002Fh3>\n\u003Cp>Install \u003Ccode>brew install --cask hammerspoon\u003C\u002Fcode>, or download the official ZIP, extract it and move Hammerspoon.app to Applications. Launch it and create \u003Ccode>~\u002F.hammerspoon\u002Finit.lua\u003C\u002Fcode>. Use its menu to edit and reload the configuration; inspect the Console for errors and interactive Lua experiments. A simple starting configuration can bind a hotkey to a notification, then grow into window or application automation. The official Getting Started guide and API documentation provide working examples.\u003C\u002Fp>\n\u003Cp>Grant Hammerspoon Accessibility access in macOS System Settings when automating desktop applications or input. Additional operations can require their own system permissions, such as Automation or Screen Recording. Only enable the permissions your configuration needs. Scripts and Spoons execute with your user's capabilities; review code before installing it.\u003C\u002Fp>\n\u003Cp>The cask also links the bundled \u003Ccode>hs\u003C\u002Fcode> command-line tool. Command-line communication is configured through Hammerspoon's IPC module; the link alone does not enable every IPC feature.\u003C\u002Fp>\n\u003Ch3 class=\"on-md-heading-1\">Systems and dependencies\u003C\u002Fh3>\n\u003Cp>The current1.1.1 release and Homebrew Cask require macOS13 or later. The Cask lists Intel and Apple Silicon Mac platforms. Hammerspoon is Mac-specific; its macOS API integrations are not supplied as Windows, Linux, iOS or Android clients. Requirements of older releases should not be substituted for1.1.1. No fixed RAM or disk minimum is specified in the official material reviewed.\u003C\u002Fp>\n\u003Cp>The official1.1.1 ZIP is9,704,557 bytes according to its GitHub release-asset metadata. Installed application, scripts and caches occupy additional space. Lua and the application's extensions are bundled; the cask declares no extra formula dependency and no explicit cask conflict. Xcode and build tools are needed to compile the source, not to use the release app. Optional Spoons, shell commands and integrations can require separately installed tools or service accounts.\u003C\u002Fp>\n\u003Cp>Custom hotkeys and window automation can overlap with shortcuts or window managers configured elsewhere. Such interactions are configuration-dependent, not a declared package conflict. Disable or adjust duplicate bindings where necessary. OS changes and target-application accessibility behavior can affect individual automation APIs.\u003C\u002Fp>\n\u003Ch3 class=\"on-md-heading-1\">Data, accounts, cost and license\u003C\u002Fh3>\n\u003Cp>Core local automation does not require a Hammerspoon account or subscription. The project is free and MIT-licensed, permitting use and modification including commercial use subject to retaining required notices. Bundled libraries and optional Spoons retain their respective licenses; hosted services invoked by your scripts can have separate costs and accounts. The official FAQ says crash reporting is enabled by default and can be disabled in Preferences; review the project's privacy policy.\u003C\u002Fp>\n\u003Cp>Homebrew zap includes \u003Ccode>~\u002F.hammerspoon\u003C\u002Fcode>, application preferences, caches and saved state. That configuration directory contains your custom Lua scripts and Spoons, so back it up before deep cleanup. Removing the app does not undo every external action performed by your scripts or delete accounts used by integrations.\u003C\u002Fp>\n\u003Ch3 class=\"on-md-heading-1\">Official references\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Product: \u003Ca href=\"https:\u002F\u002Fwww.hammerspoon.org\u002F\" target=\"_blank\" rel=\"noopener noreferrer\">https:\u002F\u002Fwww.hammerspoon.org\u002F\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>Getting Started: \u003Ca href=\"https:\u002F\u002Fwww.hammerspoon.org\u002Fgo\u002F\" target=\"_blank\" rel=\"noopener noreferrer\">https:\u002F\u002Fwww.hammerspoon.org\u002Fgo\u002F\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>API documentation: \u003Ca href=\"https:\u002F\u002Fwww.hammerspoon.org\u002Fdocs\u002F\" target=\"_blank\" rel=\"noopener noreferrer\">https:\u002F\u002Fwww.hammerspoon.org\u002Fdocs\u002F\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>FAQ and privacy: \u003Ca href=\"https:\u002F\u002Fwww.hammerspoon.org\u002Ffaq\u002F\" target=\"_blank\" rel=\"noopener noreferrer\">https:\u002F\u002Fwww.hammerspoon.org\u002Ffaq\u002F\u003C\u002Fa> and \u003Ca href=\"https:\u002F\u002Fwww.hammerspoon.org\u002Fprivacy.html\" target=\"_blank\" rel=\"noopener noreferrer\">https:\u002F\u002Fwww.hammerspoon.org\u002Fprivacy.html\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>Source, MIT license and releases: \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FHammerspoon\u002Fhammerspoon\" target=\"_blank\" rel=\"noopener noreferrer\">https:\u002F\u002Fgithub.com\u002FHammerspoon\u002Fhammerspoon\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>Official Spoon repository: \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FHammerspoon\u002FSpoons\" target=\"_blank\" rel=\"noopener noreferrer\">https:\u002F\u002Fgithub.com\u002FHammerspoon\u002FSpoons\u003C\u002Fa>\u003C\u002Fli>\n\u003C\u002Ful>\n"]