Troubleshooting

When it doesn't do the thing

The key does nothing

On macOS this is almost always the Accessibility permission. Open Diagnostics in the app: it names the platform backend it's running and which grants are missing. If you just granted it, quit and reopen the app — macOS hands the permission to a fresh process.

Nothing pasted, but the pill said Inserted

Some apps refuse synthetic paste events. The text is on your clipboard, so press Cmd+V yourself. If an app does this every time, tell us which one.

The wrong text got replaced

If you had a selection when you started dictating, your speech was treated as being about that selection. Click once to clear it first if you meant to insert new text.

The transcript is right but the formatting is wrong

Pin a style for that app in Settings. If the wording itself keeps coming out wrong, use Verbatim, which only fixes casing and punctuation.

Names come out misspelled

Add them in Vocabulary, along with what they sound like when misheard.

Linux: the key also reaches the app underneath

On X11 the keystroke isn't swallowed. That's deliberate — a keyboard grab can fail, and it would wedge your keyboard if the process died while holding it. Pick a key your apps ignore.

Linux: Wayland

There's no compositor-independent API for grabbing or synthesising a global key. The app detects the session and says so in Diagnostics. There's no tray to fall back to on Linux either — the GTK host has no status item — so run X11 or XWayland for the full experience.

Still stuck

Email support@takumi.software and include what the Diagnostics screen says. It's the fastest way for us to see what your machine sees.