Skip to content

Linux GPU integration records

Recorded evidence; these results apply to the named runs and artifacts.

Run index

Date Environment Result
Oct 1 RTX A6000, driver 580.95.05, Godot 4.7.2 FD/protocol and Vulkan/Godot lifetime/pixels passed; real DMA-BUF capture blocked by device access/extension availability
Oct 27 GTX 1050 Ti, 580.178.04, rootless Podman/TigerVNC DRI3 Both CEF backends delivered real shared pixels and animated app video
Oct 31 Same GTX, Weston 14 NVIDIA EGL and TigerVNC X11 Both native backend suites passed; Wayland had DISPLAY removed
Oct 31–Nov 1 Physical SM-T733 over Tailscale Twelve hardware/touch/background/scroll/crash/URL scenarios passed; navigation passed after cgroup fix

Oct 1 default render-thread mode was clean. Separate-thread pixel/lifetime checks passed but shutdown errors reproduced in an empty Godot project; keep that caveat. Its Ubuntu 25.04 extension needed glibc ≥2.39, not a universal Linux baseline.

Capture and transport contract

CEF lends DMA-BUF plane FDs/modifiers. Import into Vulkan, wait writer fence, acquire foreign queue ownership, copy to owned storage, release/wait before returning. A UID-checked seqpacket channel passes metadata/OPAQUE_FD with SCM_RIGHTS; handshake matches device/driver UUIDs. CUDA imports and NVENC encode on NVIDIA. The local Godot import adapter exists, but those Linux sessions use video delivery.

Require compatible GPU/driver, device permissions, external-memory FD/DMA-BUF, DRM modifiers, foreign queues, and buffer addresses. Native import rejects a shared graphics/upload queue to avoid unsynchronized submission. BGRA/RGBA8, up to 8192², ≤4 planes in one allocation are supported; disjoint or unsupported synchronization/formats fail. Imported Godot frames are bounded to three, plus one unacknowledged offer. Resize uses independent allocations.

Platform corrections

  • NVIDIA import with re-export metadata produced zero-filled frames without validation errors; the fork removes that import condition. A standalone GBM repro confirmed it.
  • X11 uses ANGLE/Vulkan and DRI3. Wayland selects from its environment or explicit GRAFFITTY_CHROMIUM_OZONE_PLATFORM; failures never silently switch to XWayland.
  • Hidden Chrome windows remain unmapped; returning native recreates the real Ozone output surface. Compositors may decline activation.
  • OSR size/show retries stop on correct dimensions, hide, or destruction.
  • The newest pending allocation survives pressure; release Vulkan before CEF shutdown.

Android and accounting follow-up

The private cgroup boundary must be joined before exec. Missing delegated controllers makes monitoring unavailable, not browser launch impossible. Cleanup retries empty-group removal for one second without killing children. All three delegated Linux accounting tests passed. Both final navigation/crash cases passed with no cgroup leaks. The coordinate fixture later corrected video/CSS mapping; eight navigation reruns passed, preserving the original failed baseline.

URL-under-load updates stayed below 3 s: Chrome 236–428 ms, Alloy 196–278 ms. The table below is a ~10 s tablet sample, not sustained 60 FPS acceptance. Earlier helper process-title parsing and ADB transfer failures were retained separately.

Limits

ARM64 was built/packaged only. Other GPU vendors, GNOME/KDE, fractional scaling, multi-monitor, and cross-adapter behavior remain unverified. Oct 1 device permissions were an environment blocker, not a requirement to run Graffitty as root. Diagnostic readback is not the production GPU path. Exit 77 skips DMA-BUF checks.

Recorded measurements

Android remote validation (2026-10-31 through 2026-11-01)

Backend Source FPS Presented FPS Video size
Chrome 60.1 32.5 564 × 1440
Alloy 60.1 35.7 564 × 1440

Commands and examples

Reproducing the native checks

test_dir=/path/to/ssd/graffitty/gpu-validation
mkdir -p "$test_dir"
g++ -std=c++20 -Wall -Wextra -Werror tests/linux_frame_protocol.cpp \
  -o "$test_dir/protocol"
"$test_dir/protocol"
g++ -std=c++20 -Wno-missing-field-initializers \
  -I"$CEF_ROOT" -I"$VULKAN_HEADERS" tests/linux_vulkan_buffer.cpp \
  -l:libvulkan.so.1 -pthread -o "$test_dir/buffer"
"$test_dir/buffer"
g++ -std=c++20 -I"$VULKAN_HEADERS" tests/linux_vulkan_producer.cpp \
  -l:libvulkan.so.1 -o "$test_dir/producer"

Native backend regression test

python3 tests/chromium_linux_backend_e2e.py \
  --host /path/to/runtime/graffitty_chromium \
  --capture-library target/chromium-linux/libchromium_capture_test.so \
  --platform wayland --backend both --artifacts .cache/linux-wayland-tests

Android remote validation (2026-10-31 through 2026-11-01)

cargo test --locked -p terminal-resource-monitor linux::tests -- --include-ignored