Install documentation for Linux (Wayland) should mention that kdotool is required

[BladeWDR]

I had an issue where espanso was falling back to XWayland instead of using native Wayland because I did not have kdotool installed.

Because of the way xwayland-satellite works, this was causing the default Electron window to open when espanso started, which is why I finally noticed that this was happening.

This was fixed by installing kdotool, but nowhere do I see this mentioned in the install documentation.

I can open a PR for it if that's helpful for you.

[smeech]

It's on my list to add information about kdotool.

Can you give me a bit more information about the difference it made for you?

[BladeWDR]

Sure. I switched to the Niri window manager this weekend, which uses xwayland-satellite instead of normal xwayland.

When kdotool is not installed, espanso falls back to X11 for clipboard support, which means that it calls xwayland.

This resulted in a window like this opening:

(This is not my screenshot, but it's the same window that I got.)

Installing kdotool made this stop popping up for me.

I'm not sure why it was bringing up an electron window specifically, since I don't think espanso uses it. Might be some strange interaction between xwayland-satellite and espanso.

The install instructions for Wayland should instruct the user to install kdotool as a dependency.