wayvnc/FAQ.md

FAQ

Q: How can I run wayvnc in headless mode/over an SSH session?

A: Set the environment variables WLR_BACKENDS=headless and WLR_LIBINPUT_NO_DEVICES=1 before starting sway, then run wayvnc as normal.

Q: How can I pass my mod-key from Sway to the remote desktop session?

A: Create an almost empty mode in your sway config. Example:

mode passthrough {
	bindsym $mod+Pause mode default
}
bindsym $mod+Pause mode passthrough

This makes it so that when you press $mod+Pause, all keybindings, except the one to switch back, are disabled.

Q: Wayvnc changes Sway's keyboard layout. Can this be fixed?

A: This happens because of a bug in how the virtual keyboard protocol interacts with a feature in sway called smart keyboard grouping. This can be remedied by either putting wayvnc on a separate seat or turning off smart keyboard grouping in sway.

Putting wayvnc in its own seat is done like this:

swaymsg seat wayvnc fallback false # create a new seat
wayvnc --seat=wayvnc

Smart keyboard grouping can be turned off like this:

swaymsg seat seat0 keyboard_grouping none

Q: Not all symbols show up when I'm typing. What can I do to fix this?

A: Try setting the keyboard layout in wayvnc to the one that most closely matches the keyboard layout that you're using on the client side. An exact layout isn't needed, just one that has all the symbols that you use.