A VNC server for wlroots based Wayland compositors

Go to file

Andri Yngvason 990e57fa89 keyboard: Improve key code lookup The shift level for each symbol is now included in the lookup table, so it's more robust for various keyboard layouts.		2020-01-03 20:03:02 +00:00
include	Add seat selection	2019-12-31 14:01:22 +00:00
protocols	protocols: Add virtual-keyboard	2019-12-24 15:54:19 +00:00
src	keyboard: Improve key code lookup	2020-01-03 20:03:02 +00:00
.gitignore	.gitignore: Add .ycm_extra_conf.py	2019-12-22 21:46:16 +00:00
COPYING	Add license and copyright notice	2019-10-08 18:41:23 +00:00
README.md	README: Talk about listening on different interfaces	2019-12-31 10:50:02 +00:00
meson.build	Add seat selection	2019-12-31 14:01:22 +00:00

README.md

wayvnc

Introduction

This is a VNC server for wlroots based Wayland compositors.

Building

Runtime Dependencies

EGL
libuv
libxkbcommon
neatvnc
OpenGL ES V2.0
pixman

Build Dependencies

GCC
meson
ninja
pkg-config

The easiest way to satisfy the neatvnc dependency is to clone it into the subprojects directory:

mkdir subprojects
git clone https://github.com/any1/neatvnc.git subprojects/neatvnc

Setting the buildtype flag is not required but it is recommended as there are significant performance gains to be had from an optimised build.

meson build --buildtype=release
ninja -C build

Running

Wayvnc can be run from the build directory like so:

./build/wayvnc

☢️ The server only accepts connections from localhost by default. To accept connections via any interface, set the address to 0.0.0.0 like this:

./build/wayvnc 0.0.0.0

⚠️ Do not do this on a public network or the internet. Wayvnc does not support any kind of encryption or password protection. A good way to protect your VNC connection is to use SSH tunneling while listening on localhost.