// troubleshooting guide · hammerspoon

Hammerspoon UI Not Showing in Full-Screen Apps

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

RUNBOOK · hammerspoon/no-ui-in-fullscreen1 FIX

// quick answer

Hammerspoon alerts and canvases do not appear over full-screen apps when the Dock icon is on. Turn the Dock icon off.

Most likely fix: Disable the Dock icon

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Disable the Dock icon

    1. 01Open Hammerspoon Preferences and untick Show dock icon
    2. 02Or add hs.dockIcon(false) to init.lua and reload
    Did this fix it?

Symptoms

Alerts, chooser or canvas elements are invisible above a full-screen app.

Why it happens

  • C-01Dock icon enabled

// this guide also covers

  • hammerspoon fullscreen
  • hammerspoon alert not showing

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 missing or lost data guides →

Other Hammerspoon errors