Add reproducible Python baseline and Guacamole graphics presets

This commit is contained in:
cabbage committed 2026-10-08 06:55:14 +00:00
1 parent 620f882fe2
commit 98a474696b
8 files changed
+380 -35

No files matched your search

+37 -1
View File
@@ -24,11 +24,47 @@ password to the VM. Clipboard, drives, printing, audio, microphone input, GFX,
and display-resize extensions are disabled because the fixture's VirtualBox
RDP4 server does not handle them reliably.
## Network and graphics quality
Use `--graphics minimal|low|normal|high` on `up`, or set `RDP_ACCESS_GRAPHICS`:
| Mode | Requested display | Color | Intended use |
| --- | --- | --- | --- |
| `minimal` | 800×600, 96 DPI | 8-bit / 256 colors | Lowest pixel/color budget; substantial color loss |
| `low` | 1024×768, 96 DPI | 16-bit | Slow/metered networks, terminal work |
| `normal` | Browser dimensions/DPI | 24-bit | Default, same behavior as the original helper |
| `high` | 1920×1080, 96 DPI | 24-bit | Fast connections and larger desktops |
```sh
test/rdp-access/rdp-access up --bind 0.0.0.0 --public-host x1.xcel.me --graphics minimal
test/rdp-access/rdp-access up --bind 0.0.0.0 --public-host x1.xcel.me --graphics low
test/rdp-access/rdp-access up --bind 0.0.0.0 --public-host x1.xcel.me --graphics normal
```
The choice is saved per gateway profile and reused when omitted. `status`
prints the saved `graphics` mode. A change rewrites the connection mapping
while retaining the gateway and tunnels; disconnect/reconnect the desktop to
apply it. Existing sessions continue with their original display settings.
If an old browser connection holds the single VRDE slot, close it or use the
documented `repair` action before reconnecting.
All modes keep wallpaper, themes, font smoothing, menu animation, full-window
drag, audio/device redirection, and GFX disabled. Lossy compression remains
available to Guacamole's normal heuristics. Display dimensions/color depth are
requests to the RDP server; the negotiated framebuffer can differ if the
server restricts them. A smaller display reduces pixel traffic; it cannot
eliminate network latency. See the [Guacamole 1.6 display settings](https://guacamole.apache.org/doc/1.6.0/gug/configuring-guacamole.html#display-settings).
There is no RDP black-and-white/grayscale parameter: `minimal` requests a
256-color palette. Static terminal work and smaller windows generally cost
less than scrolling images or video. The RDP backend does not provide VNC's
`quality-level`/`compress-level` knobs; those must not be added to this RDP
mapping as if they controlled its encoding.
## Current fixture quick start
The following is the copy/paste path for the documented `rvbox-win10-test`
fixture. Run it from the repository root. The first command acquires the
exclusive VM lease, restores the clean administrator-enabled snapshot, starts
exclusive VM lease, restores the clean Python/administrator-enabled snapshot, starts
the VM, and applies the VRDE display keepalive. The second command starts the
Docker-only gateway at the currently published endpoint: