Troubleshooting

Troubleshooting

Start here, then follow the link into the page with the detail for your problem.

Setup and configuration

• The modal blocks recording/pasting with a setup card. The active profile is missing a provider, model, key, or (for openai-compatible) a base URL. Fill in the highlighted fields. See Settings reference and Providers.
• No templates in the dropdown. You have not populated them yet. Settings, Templates, Populate. See Quick start.
• The plugin asks for a passphrase / says it is locked. You are in passphrase encryption mode and the key is not unlocked. Enter your passphrase. See Secrets and sync.
• Keys disappeared after syncing to another device. Encrypted keys do not decrypt cross-device in some modes; this is expected. Re-enter the key on that device, and consider excluding secrets.json.nosync from sync. See Secrets and sync.

Provider errors

• An error names the provider and an HTTP status. That is the provider rejecting the request (bad key, wrong model id, rate limit, oversized audio). Read the message; it is attributed to the provider on purpose.
• "Maximum note length" / max-tokens error. Your output cap is above the model's limit. Lower it in the profile. See Providers.
• Recording too large. You hit a provider's size or duration ceiling. Switch to a higher-ceiling provider (AssemblyAI, Rev.ai) or shorten the clip. Limits are listed in Providers and Commands and menus.

Recording

• "No audio detected" warning. The mic is muted, dead, or not granted permission for several seconds. Check your OS mic permissions and input device.
• Recording stops when the screen sleeps (mobile). A WebView limitation, mitigated by a wake lock. See Mobile.

Self-hosted whisper.cpp

Port conflicts, antivirus, startup timeouts, the loopback refusal, and FUTO -ac issues are all covered on Self-hosting: whisper.cpp.

Self-hosted / local LLMs

Connection refused, 404 on the /v1 path, model-not-found, LAN access, and truncated output are covered on Self-hosting: local and remote LLMs.

Still stuck?

Open an issue on the repository with the provider, the exact error text, and what you were doing. For self-hosted setups, include the relevant log tail.

Back to Home