Troubleshooting
Find solutions by symptom, and contact us if the problem continues.
Check these first
These three steps fix most problems.
- Accessibility permission: In System Settings ▸ Privacy & Security ▸ Accessibility, make sure Typeside is turned on. Without this permission, no features work.
- AI model:
- Autocomplete, Improve, Translate, and Summarize need the on-device light model, which you download during setup.
- Prompt, Shorten, Expand, and skills need an on-device general model or a cloud AI service.
- Restart: Click the Typeside icon in the menu bar, choose Quit Typeside, then open Typeside again. After you change permissions, a restart is sometimes needed for them to take effect.
Solutions by symptom
| Symptom | Where to look |
|---|---|
| Shortcuts don't work | Install and permissions |
| Autocomplete suggestions don't appear | Autocomplete |
| The quick edit button doesn't appear when you select text | Quick edit |
| Clicking Improve or Translate shows "Preparing this feature" | Quick edit |
| Pressing ⌥Space doesn't open Prompt | Prompt |
| Prompt or a skill is locked | AI models |
| Dictation doesn't start | Dictation |
| You want Typeside not to appear in a specific app | Install and permissions |
| A screen recording alert keeps appearing | Install and permissions |
| Your API key is rejected or requests are limited | Connect a service |
| You can't register your license | Activate your license |
| Skill results aren't what you want | Writing good instructions |
Known limitations
- Typeside doesn't work in password fields.
- In some apps, such as web browsers, autocomplete suggestions or the quick edit button may appear slightly away from the cursor or the selected text.
- Improve, Translate, and Summarize are designed for short text. Run them on long documents one paragraph at a time. If the text is too long, the result may stop partway.
- The on-device general model can handle only a set length at once. If your text is longer, you see "This is longer than the on-device model can handle at once." Split the text, or use a cloud AI service.
FAQ
You can change the shortcut that opens Prompt with Prompt shortcut in Settings ▸ Editing. The dictation shortcut, ⌥ V, can't be changed.
Click the Typeside icon in the menu bar, then choose Quit Typeside. Closing the main window leaves Typeside running in the menu bar.
Contact us
If these steps don't solve the problem, let us know on the contact page. Include which app you were using and what you did when the problem happened, so we can look into it quickly.