// troubleshooting guide · hammerspoon

Hammerspoon Cannot Find Application By Name

Status
Fixed in latest version
platforms:
macOS
updated:
November 16, 2026
Method
how we research
Share

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

  1. FIX 1List real application names

    1. 01Open the Console
    2. 02Run: hs.fnutils.each(hs.application.runningApplications(), function(app) print(app:title()) end)
    3. 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 us

Watch Hammerspoon Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All not loading, error messages & connection guides →

Other Hammerspoon errors