Where Is the Hammerspoon Config Folder?
Hammerspoon init.lua and Spoons folder on macOS.
Last updated
Hammerspoon loads init.lua from a dotfiles folder in home, with Spoons plugins and hs.settings state beside it. The whole automation rig is plain Lua under version control.
Reload from the menubar after every spoon experiment since errors print to console, not dialogs. A broken require line disables all hotkeys at once.
Where Hammerspoon stores this, by platform
~/.hammerspoon/init.lua
Entry script with Spoons in ~/.hammerspoon/Spoons and persisted state nearby. Console under the menubar shows load errors. Symlink the folder straight into dotfiles.
Frequently asked questions
How do I reload Hammerspoon config?
Edit init.lua above then Reload Config from the menubar. Console errors name the failing spoon and line.
Where do Hammerspoon Spoons live?
In the Spoons subfolder next to init.lua above. Installed spoons keep their own docs and hotkey defaults.
Notice an outdated path? Let us know.