Browse Source

update documentation to reflect support for multiple displays

Daniel Sheffield 2 weeks ago
parent
commit
0eb75e6d10
1 changed files with 22 additions and 9 deletions
  1. 22 9
      android-usb-vnc/system/usr/share/man/man7/android-usb-vnc.7

+ 22 - 9
android-usb-vnc/system/usr/share/man/man7/android-usb-vnc.7

@@ -19,11 +19,10 @@
 .SH Use Android tablet (or phone) as extra display
 .PP
 This dotfiles target uses adb reverse port forwarding and Xvfb to expose an X11
-display of VNC.
+display over VNC.
 .PP
-The udev rules and systemd units automatically launch an X11 display (:19) via
-Xvfb, and an xpra server on the virtual display. The xpra server runs an LXQt
-desktop.
+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.
 .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.
@@ -43,12 +42,21 @@ and then later has a display attached.
 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.
+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
-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.
+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.
 .SS xpra
 .PP
 The xpra debian package repos have the latest version, however, I found the
@@ -57,6 +65,8 @@ packages seem to have missing dependencies:
 lz4
 .IP \[bu] 2
 python3-opengl
+.IP \[bu] 2
+python3-paramiko
 .PP
 You will need to install these debian packages for xpra to work
 correctly.
@@ -66,3 +76,6 @@ can start one, but can not stop it!
 .PP
 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