mirror of
https://github.com/VallierDev/uu-remote-linux.git
synced 2026-11-16 08:50:40 +01:00
Squashed from the Codex v0.1.9 branch (reviewed): - Clear stale input when a desktop session starts or ends and at service start/stop: X11 releases every pressed key/button on the display (a stuck XTest button blocked all clicks after a VM reboot), uinput resets its own devices, Wayland/portal sweep the keys this host can emit. A per-desktop lease stops late callbacks of an old connection from touching a new one; file/terminal/port-mapping peers never release desktop input. - Native Wayland (--features wayland): double-buffered screencopy pipeline, viewer frame rate drives the capture rate, opt-in dma-buf (UU_WAYLAND_DMABUF=1, linear only, falls back to SHM). VM-measured only. - Internal QA records (docs/validation, contrib/tests) removed from the public tree and ignored; they stay in the private project. Co-Authored-By: Claude Opus 5.5 <[email protected]>
24 lines
1.7 KiB
Markdown
24 lines
1.7 KiB
Markdown
# Virtual user-bus desktop acceptance
|
|
|
|
Install Xvfb, xauth, xdpyinfo, Xfce and dbus-user-session (Debian) or dbus-broker (Arch).
|
|
The default is `UU_VIRTUAL_BUS=user`; use it on a dedicated headless account with no real
|
|
GUI session. Its D-Bus and systemd activation environment is shared by all that user's apps.
|
|
`private` isolates ordinary D-Bus activation but cannot redirect systemd-activated programs.
|
|
|
|
1. Install the script in `~/.local/bin`, the unit in `~/.config/systemd/user`, and
|
|
`virtual-display.conf` in the host service's `.service.d/` directory.
|
|
2. `sudo loginctl enable-linger "$USER"`; set `UU_VIRTUAL_SESSION=startxfce4` in the desktop
|
|
unit. `systemctl --user daemon-reload`; enable both units. A different display needs a
|
|
matching `DISPLAY` and `XAUTHORITY=%t/uu-virtual-N.Xauthority` in the host drop-in.
|
|
3. Reboot a disposable VM with graphical login disabled. Before logging into a desktop,
|
|
check both user units are active, Xvfb is `:99`, no real GUI login session exists, and
|
|
host availability is `ready`. The desktop unit uses notify readiness after authenticated
|
|
X11 access succeeds, so the host does not race the X socket.
|
|
4. `DISPLAY=:99 XAUTHORITY="$XDG_RUNTIME_DIR/uu-virtual-99.Xauthority" xdpyinfo` must work.
|
|
`gnome-terminal` launched over the user bus must open on `:99`. Check its window via
|
|
`xdotool search --class '[Gg]nome.[Tt]erminal|gnome-terminal-server'` (window
|
|
classes vary by GNOME Terminal version; the server process name is not always
|
|
its window class). Do not log window titles or terminal text.
|
|
5. Restart/stop the desktop unit: its Xvfb, desktop children and authority file must be
|
|
removed. A stale pre-existing display is rejected. The TCP X11 listener is disabled.
|