Troubleshooting
What to check when the toolbar doesn’t show up, AI actions fail, or something else isn’t right.
The toolbar never shows up
Check these in order:
- Is auto pop-up paused? Click the menu bar icon. If you see Resume Auto Pop-up, click it.
- Is Accessibility access on? Open Settings › Permissions. If it says the permission isn’t on, follow these steps.
- Is automatic pop-up turned on? In Settings › General, make sure “Show toolbar automatically when text is selected” is on.
It doesn’t show up in one app
- Is the app excluded? Look in Settings › Excluded Apps. Terminals, password managers and remote desktop apps are on the list by default. Select an app and press Delete to remove it.
- Try the shortcut. Select the text, then press ⌃⌥Space. Some apps don’t report a selection the usual way, and the shortcut still works there. It’s also how you show the toolbar after selecting with the keyboard.
- Just switched to the app? In some apps built with web technology (like VS Code, Notion or Obsidian), tappop needs a couple of seconds after you switch to them the first time.
The toolbar shows up when I don’t want it
- Hold ⌘ while selecting to skip the toolbar once.
- Add the app to Settings › Excluded Apps — choose it from running apps or from the Applications folder.
- Pause it for a while from the menu bar icon › Pause Auto Pop-up.
AI actions don’t work
- Asked to add a provider? You haven’t set one up yet. Add one in Settings › AI — see Set Up AI.
- Invalid key, out of credit, timed out, or too many requests — the result panel says which one and has a button to the right settings. Click Details in the panel to see the provider’s original message.
- The test passes but results look wrong — check the model name, then try another model. Small local models can struggle with long text.
My clipboard
To read a selection in some apps, tappop briefly copies it and then puts your clipboard back the way it was, so you shouldn’t lose anything. If you use a clipboard manager, it may still record that copy. Text that tappop itself writes (for example, when replacing a selection) is marked so clipboard managers skip it.
Launch at login doesn’t work
- Allow tappop in System Settings › General › Login Items.
- Make sure tappop is in the Applications folder. A copy running from Downloads or the DMG may not start at login.
I hid the menu bar icon and can’t get back to Settings
Open tappop again from the Applications folder in Finder. Settings opens, and you can turn Show icon in menu bar back on in General.
Updates
Choose Check for Updates… from the menu bar icon, or click it in Settings › About. You can always download the latest version from the download page.