Wayland Support

Voice Dictation on Wayland

Full voice dictation support for modern Wayland compositors. Works with GNOME, KDE Plasma, Sway, Hyprland, and more. No X11 required.

Native IBus Integration

Text injection via IBus engine works seamlessly on Wayland compositors like GNOME, KDE, Sway, and Hyprland.

X11 Fallback Support

Automatic fallback to xdotool when running under XWayland or traditional X11 sessions.

Desktop Agnostic

Works with GNOME, KDE Plasma, Sway, Hyprland, river, and other Wayland compositors.

Supported Wayland Compositors

CompositorMethodStatusNotes
GNOME (mutter)IBusFull supportDefault on Ubuntu, Fedora, Debian GNOME editions
KDE Plasma (KWin)IBusFull supportWorks with IBus input method framework
SwayIBus / wtypeFull supporti3-compatible Wayland compositor
HyprlandIBus / wtypeFull supportDynamic tiling Wayland compositor
riverIBus / wtypeFull supportDynamic tiling Wayland compositor
XWayland appsxdotoolFull supportX11 apps running under Wayland

Quick Setup Guide

1

Install IBus

Most distributions include IBus by default. If not:

sudo apt install ibus ibus-gtk ibus-gtk3
2

Start IBus Daemon

Ensure the IBus daemon is running in your session:

ibus-daemon -drx
3

Run Vocalinux

Vocalinux will auto-detect Wayland and configure IBus:

vocalinux

How Wayland Text Injection Works

Unlike X11 where applications can simulate keyboard input globally, Wayland's security model requires a different approach. Vocalinux uses:

  • IBus Engine — A custom IBus input method that receives text from Vocalinux and types it into the focused application
  • wtype — Native Wayland typing tool for compositors that support the virtual keyboard protocol
  • X11 Fallback — xdotool for XWayland applications

Start Dictating on Wayland

Vocalinux automatically detects your display server and configures the appropriate text injection method. Just install and run.