Troubleshooting

Fixes for the handful of things that can go wrong, in the order most likely to be the cause.

Icons not appearing in the panel

Open System Settings → Privacy & Security → Accessibility and confirm Overflow is enabled.
Open System Settings → Privacy & Security → Screen Recording and confirm Overflow is enabled.
Quit and reopen Overflow after granting either permission — macOS doesn't always apply it live.
Quit and reopen the app whose icon is missing; Overflow reads live state, not a cache.

After updating Overflow

On self-signed, non-notarized builds, macOS can silently re-revoke Screen Recording access when the app binary's signature changes between versions. If icons stop appearing right after an update, re-check both permissions in Settings — you may need to remove and re-add Overflow in Privacy & Security → Screen Recording even if it still looks granted.

A hidden icon does nothing when clicked

Some apps' status items don't respond to a simulated click while they're hidden or off-screen — the accessibility action silently fails. When that happens, Overflow falls back to opening the app itself instead of mirroring its menu, and the tile flashes orange to signal that a fallback occurred. This is a limitation of the third-party app's menu bar item, not something Overflow can force past.

Panel position quirks

The panel anchors itself relative to the Overflow menu bar icon and the current display's notch geometry. On multi-monitor setups, or right after connecting or disconnecting an external display, the panel can occasionally open in a stale position for one launch. Closing and reopening it resolves this, as Overflow re-reads the display layout each time the panel opens.

Fully restarting Overflow

Open the panel and click the power button to quit Overflow.
Relaunch Overflow from Applications (or Spotlight).

Still stuck?

Email support@kepptic.com — see the Support page for known limitations too.