Skip to main content
Find your symptom and open it.
The download is fine. Do not delete it. macOS shows that message for any app it cannot trace to a paid Apple Developer account, and SpeakoFlow is not signed yet.One Terminal command clears it, once per version you install:
Full explanation in Install.
Expected. An AppImage is one self-contained file and cannot register an icon or app-menu entry with your desktop, so the file stays generic in your file manager. The icon does appear once the app is running.Install the .deb instead on Debian, Ubuntu 24.04+, Mint 22+, Pop!_OS, or Tuxedo OS. A helper like Gear Lever or AppImageLauncher also adds the integration. Details in Install.
Microphone access is blocked at the OS level. Grant it, then restart the app.
  • Windows. Settings → Privacy & security → Microphone, including desktop-app access.
  • macOS. System Settings → Privacy & Security → Microphone.
  • Linux. Your system’s sound or privacy settings.
SpeakoFlow needs Accessibility permission to type into other apps. Grant it in System Settings → Privacy & Security → Accessibility, then restart the app.
Grant Screen Recording permission in System Settings → Privacy & Security → Screen Recording, then restart SpeakoFlow for it to take effect.
The overlay has to float above every other window. On Linux that requires either the wlr-layer-shell protocol (wlroots compositors like Sway and Hyprland, and KDE Plasma) or classic X11 “keep above” stacking.Native GNOME/Wayland supports neither. Mutter deliberately does not implement wlr-layer-shell, and Wayland gives apps no way to raise themselves above others.SpeakoFlow handles this automatically. When it detects GNOME on Wayland it runs under XWayland, where “keep above” works and the overlay floats normally. This is on by default and needs no setup. X11 sessions and KDE or wlroots Wayland already work out of the box and are left on native Wayland.Two escape hatches, if you need them:
  • Force native Wayland anyway, accepting that the overlay may not stay on top: launch with SPEAKOFLOW_ALLOW_WAYLAND=1.
  • Disable layer shell, if the overlay misbehaves under a layer-shell compositor: SPEAKOFLOW_NO_GTK_LAYER_SHELL=1.
Setting GDK_BACKEND yourself always wins. SpeakoFlow never overrides an explicit choice.
If dictation and assistant hotkeys do not respond and your log repeats rdev grab error: ... PermissionDenied (errno 13), the app cannot read your input devices. This affects the handy-keys keyboard engine, which reads /dev/input/event* and needs your user in the input group.Either grant access:
Then log out and back in, because group membership only applies to new sessions.Or switch the keyboard engine to Tauri in Settings → General → Experimental, which uses the compositor’s global-shortcut API and needs no special permissions. Tauri is already the default engine on Linux, so this only affects you if you switched to handy-keys. See General settings.
On some Linux setups a trackpad pinch-to-zoom gesture crashes the window, with Received invalid message: 'DrawingArea_CommitTransientZoom' in the logs.This is a bug in WebKitGTK, the Linux web engine Tauri uses, not in SpeakoFlow. It affects many WebKitGTK-based apps and is tracked upstream in tauri#13115 and wry#544.Until there is an upstream fix, avoid pinch-to-zoom inside the app window. Updating your system’s webkit2gtk-4.1 packages can also help, since newer releases handle the gesture more gracefully.
Increase the paste delay and the extra recording buffer in Debug settings.If one specific app misbehaves with clipboard paste, try the Direct paste method.
Portable installs cannot update automatically.Download the latest NSIS installer from GitHub Releases, install it to the same folder, then copy your Data/ folder (settings, models, recordings) from the old version to the new one.
Still stuck? Open an issue with your log level raised. See Debug & advanced.
Last modified on August 7, 2026