Full overlay behavior requires layer-shell. Known-good layer-shell targets include Hyprland,
Sway, River, Wayfire, Niri/COSMIC, and KDE Plasma/KWin.
GNOME uses the xdg-shell/portal fallback, so some fullscreen and input behavior differs.
Light passthrough requires layer-shell. It is disabled on the xdg-shell fallback because keyboard passthrough cannot be made reliable there.
Some compositors handle fullscreen or input differently.
The input HUD can only show the input Wayscriber itself receives unless system-wide
capture is available: a Wayland client cannot see another app’s keystrokes. System mode
needs a build with the input-monitor feature and read access to /dev/input (usually
input group membership); without both, the HUD reports overlay input only. In system
mode the keyboard layout comes from the environment (XKB_DEFAULT_LAYOUT and friends),
which can differ from the compositor’s live layout.
Capture shortcuts need external tools for best results (see Installation → Build from source if you are not using packages).