|
|
@@ -18,15 +18,40 @@
|
|
|
.hy
|
|
|
.SH Use Android tablet (or phone) as extra display
|
|
|
.PP
|
|
|
-Uses adb reverse port forwarding and Xvfb to expose an X11 display of
|
|
|
-VNC.
|
|
|
+This dotfiles target uses adb reverse port forwarding and Xvfb to expose an X11
|
|
|
+display of VNC.
|
|
|
.PP
|
|
|
-Also, an xpra server is started to make the auxilary display accessible
|
|
|
-on the host.
|
|
|
+The udev rules and systemd units automatically launch an X11 display (:19) via
|
|
|
+Xvfb, an x11vnc server, and an xpra server shadowing the virtual display.
|
|
|
+.PP
|
|
|
+The X11 display persists even when the device is unpluged, allowing the device
|
|
|
+to replug later and continue using the session on the display.
|
|
|
+.PP
|
|
|
+To reduce the attack surface, the x11vnc server runs (on localhost) only while
|
|
|
+the Android device is connected.
|
|
|
+.PP
|
|
|
+The Android device can connect (passwordless) via localhost:5900 using any
|
|
|
+preferred VNC client.
|
|
|
+.PP
|
|
|
+The host can also connect via xpra to work on the virtual display session
|
|
|
+simultaneously, and long after the Android device is disconnected. This is
|
|
|
+particularly useful if the host is headless for a while (say, while travelling)
|
|
|
+and then later has a display attached.
|
|
|
+.SS adb
|
|
|
+.PP
|
|
|
+The Android Debug Bridge is used to forward the x11vnc port (5900) on localhost
|
|
|
+to the android device. You can install adb via your package manager.
|
|
|
+.PP
|
|
|
+Currently only one Android device is supported as the virtual display created
|
|
|
+via Xvfb is aligned to the resolution of the first connected device.
|
|
|
+Subsequently connected devices may not have the optimal screen resolution.
|
|
|
+.PP
|
|
|
+In the future, virtual displays per-device shall be added. At which point it
|
|
|
+will be possible to use multiple devices albeit on separate X11 displays.
|
|
|
.SS xpra
|
|
|
.PP
|
|
|
-The xpra repos have the latest version, however, I found the packages
|
|
|
-seem to have missing dependencies.
|
|
|
+The xpra debian package repos have the latest version, however, I found the
|
|
|
+packages seem to have missing dependencies:
|
|
|
.IP \[bu] 2
|
|
|
lz4
|
|
|
.IP \[bu] 2
|
Daniel Sheffield