Troubleshooting

Check whether your issue is covered below. For general questions, like what Owlfy is, what it costs, or whether it needs the internet, see the FAQ. If not, contact us from Settings → About → Help & Support. Including your Owlfy version, operating system, what you did, and any error message helps us solve it faster.

Nothing happens when I press a voice key

Check the keys in Settings → General and make sure they don’t clash with another app’s shortcuts.
On macOS, make sure Accessibility is on under Settings → General → System permissions. If you just granted it, restart Owlfy.

I wanted to type but it ran a command (or the other way around)

The keys do different jobs: the Voice Writing key types, the Voice Action key acts. The mouse wheel button is a Voice Action key by default; you can switch it to Voice Writing or turn it off in Settings → General.

No sound, or poor recognition

Pick the right microphone in Settings → Voice and test it.
Make sure your system allows Owlfy to use the microphone.
Set Primary language to the language you actually speak.
Add names and terms that keep getting misheard to Voice Writing → Dictionary.
For recording computer audio in live dictation, make sure you chose System and something is actually playing.

My text didn’t appear

Click into the text box first so the cursor is there.
Check the Accessibility permission.
Your text isn’t lost. Open Voice input history from the voice bar and click it to paste again.

The AI didn’t pick up my selected text or file

Select it first, then start the task. If that still doesn’t work, paste the text into the AI Agent or drag the file in.

The browser won’t connect

In Connect → Browser, check whether your browser shows Not installed. If it’s installed, click Connect and wait until it says Connected. If no browser is found, install a supported one and refresh.

My local model won’t connect

Make sure Ollama or LM Studio is running.
Check the API address and port.
Make sure the model name matches.
After adding it, remember to switch to it in the AI Agent’s model picker.

Chats fine but won’t work with files? Try a model that supports tool calling. See Connect a Local Model.

Local Speech Recognition is stuck preparing

Check the download progress in Settings → Privacy. Make sure you’re online and have enough disk space, and click Retry if it fails. Speech recognition switches to local only once it’s ready.

A skill is installed but doesn’t work

Read the message to see what’s missing: a third-party sign-in, an internet connection, or Credits. Sort that out and try again.

A scheduled task didn’t run on time

In the Automated Action panel, check that the task is enabled and the time and schedule are right.
Your computer must be on and awake, with Owlfy running, at the scheduled time.
For tasks that go online, check your internet connection.

No reply to my phone messages

In Connect → Mobile Owlfy, check that your account is still linked.
Make sure your computer is on, Owlfy is running, and you’re online.
Check whether a task on your computer is waiting for your confirmation or still running.

I’m out of Credits

Click the membership card at the bottom of the main menu to check your Credits. Top up by upgrading, completing tasks, or redeeming a code. See Credits.

Linux users

Owlfy on Linux is built mainly for X11 desktops. On Wayland, global shortcuts, screenshots, reading selected text, and auto-paste may be less reliable. If you run into trouble, try an X11 session.

Quick Start · Settings