// troubleshooting guide · hammerspoon
Hammerspoon Cannot Find Application By Name
- Status
- Fixed in latest version
- platforms:
- macOS
- updated:
- November 16, 2026
- Method
- how we research
RUNBOOK · hammerspoon/app-name-not-found1 FIX
// quick answer
Some apps report a different name than the menu bar, for example Microsoft Word instead of Word. List running names to find the right one.
Most likely fix: List real application names
How to fix it
// try these in order, the most common fix is first
FIX 1List real application names
- 01Open the Console
- 02Run: hs.fnutils.each(hs.application.runningApplications(), function(app) print(app:title()) end)
- 03Use the exact name printed
Did this fix it?
Symptoms
hs.application.find or launchOrFocus fails for an app that is clearly running.
Why it happens
- C-01Name mismatch between menu bar and system
// this guide also covers
- hammerspoon application not found
- hammerspoon microsoft word name
Still not working?
If Hammerspoon keeps failing, you're not alone. See every Hammerspoon problem users report or the alternatives people switch to.
Done fighting Hammerspoon? Our small team builds your own Hammerspoon alternative, or any software you need: web, mobile, games, desktop. Price agreed together.
Talk to usThe same problem in other apps
All not loading, error messages & connection guides →
BetterTouchTool Is Currently Disabled Error (BetterTouchTool)
karabiner.json Is Not Owned by a Valid User Error (Karabiner-Elements)
Other Hammerspoon errors
- Hammerspoon Accessibility Permission Not Working
- Hammerspoon Keystrokes Not Working
- Hammerspoon Hotkeys Stop Working
- Hammerspoon Timer or Watcher Stops Working
- Hammerspoon Modal Hotkeys Not Working
- Hammerspoon UI Not Showing in Full-Screen Apps
- Hammerspoon selectMenuItem Not Working From Console
- Hammerspoon v2: What Changes and Should You Wait