|
|
@@ -18,20 +18,33 @@
|
|
|
.hy
|
|
|
.SH Use Android tablet (or phone) as extra display
|
|
|
.PP
|
|
|
-This dotfiles target uses adb reverse port forwarding and Xvfb to expose an X11
|
|
|
+.PP
|
|
|
+This
|
|
|
+.B dotfiles
|
|
|
+target uses adb reverse port forwarding and Xvfb to expose an X11
|
|
|
display over VNC.
|
|
|
.PP
|
|
|
-The udev rules and systemd units automatically launch an X11 display via Xvfb,
|
|
|
-and an xpra server on the virtual display. The xpra server runs an LXQt desktop.
|
|
|
+The
|
|
|
+.B udev
|
|
|
+rules and
|
|
|
+.B systemd
|
|
|
+units automatically launch an X11 display via
|
|
|
+.B xvfb
|
|
|
+, and an xpra server on the virtual display. The xpra server runs an
|
|
|
+.B LXQt
|
|
|
+desktop.
|
|
|
.PP
|
|
|
The X11 display persists even when the device is unplugged, 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.
|
|
|
+To reduce the attack surface, the
|
|
|
+.B 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.
|
|
|
+The Android device can connect (passwordless) via
|
|
|
+.I
|
|
|
+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
|
|
|
@@ -39,24 +52,36 @@ 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.
|
|
|
+The
|
|
|
+.B Android Debug Bridge
|
|
|
+is used to forward the
|
|
|
+.B x11vnc
|
|
|
+port (5900) on localhost to the android device. You can install adb via your
|
|
|
+package manager.
|
|
|
.PP
|
|
|
Multiple devices are supported. A separate virtual display is started for each
|
|
|
-distinct device. Virtual display numbers start from :101 and the next available
|
|
|
-number is used for each device in the order they are attached. The display
|
|
|
-remains associated to that device (in case it is replugged later) until next
|
|
|
-boot.
|
|
|
-.PP
|
|
|
-The xpra_attach_hdpi.sh helper script can be used to attach to the first such
|
|
|
-display. A display number can also be specified (eg. xpra_attach_hdpi.sh 102) to
|
|
|
-attach to a virtual display for a specific device.
|
|
|
-.PP
|
|
|
-The mapping from device to display is found in: /var/lib/xvfb
|
|
|
-.PP
|
|
|
-NOTE; You may have to set fs.inotify.max_user_instances to a higher
|
|
|
-value to allow multiple LXQt desktops to run consurrently without warnings about
|
|
|
-too many open files.
|
|
|
+distinct device. Virtual display numbers start from
|
|
|
+.B 101
|
|
|
+and the next available number is used for each device in the order they are
|
|
|
+attached. The display remains associated to that device (in case it is replugged
|
|
|
+later) until next boot.
|
|
|
+.PP
|
|
|
+The
|
|
|
+.B xpra_attach_hdpi.sh
|
|
|
+helper script can be used to attach to the first such display. A display number
|
|
|
+can also be specified (eg.
|
|
|
+.B xpra_attach_hdpi.sh 102
|
|
|
+) to attach to a virtual display for a specific device.
|
|
|
+.PP
|
|
|
+The mapping from device to display is found in:
|
|
|
+.I
|
|
|
+/var/lib/xvfb
|
|
|
+.PP
|
|
|
+NOTE; You may have to set
|
|
|
+.I
|
|
|
+fs.inotify.max_user_instances
|
|
|
+to a higher value to allow multiple LXQt desktops to run consurrently without
|
|
|
+warnings about too many open files.
|
|
|
.SS xpra
|
|
|
.PP
|
|
|
The xpra debian package repos have the latest version, however, I found the
|
|
|
@@ -71,11 +96,17 @@ python3-paramiko
|
|
|
You will need to install these debian packages for xpra to work
|
|
|
correctly.
|
|
|
.PP
|
|
|
-lz4 is needed to communicate with the spawned xpra server, otherwise you
|
|
|
-can start one, but can not stop it!
|
|
|
+.B lz4
|
|
|
+is needed to communicate with the spawned xpra server (eg.
|
|
|
+.B xpra stop
|
|
|
+), otherwise you can start one, but can not stop it!
|
|
|
.PP
|
|
|
-python3-opengl is required if you want reasonable performance when you
|
|
|
+.B python3-opengl
|
|
|
+is required if you want reasonable performance when you
|
|
|
connect to a shadowed display.
|
|
|
.PP
|
|
|
-python3-paramiko is required if you want to use xxpprrraa uuppggrraaddee or xxpprraa
|
|
|
-ddeesskkttoopp--uuppggrraaddee
|
|
|
+.B python3-paramiko
|
|
|
+is required if you want to use
|
|
|
+.B xpra upgrade
|
|
|
+or
|
|
|
+.B xpra desktop-upgrade
|
Daniel Sheffield