fix: prefer falkon for xvfb desktop browsing #65

2026-05-25T12:33:39Z

hongming commented

2026-05-25 12:33:39 +00:00

Fixes the display-browser rendering path after Chrome 148 remained black under the Xvfb/xfce/noVNC display even with GPU/compositor flags.

Live finding:

Chrome window existed and was focused, but direct window capture was all black.
Falkon rendered https://example.com correctly in the same Xvfb display.

Changes:

expose falkon in desktop_status
prefer Falkon for desktop_open_url when installed
keep Chrome fallback with Xvfb-safe flags
bump runtime patch version to 0.3.2

Verification:

live EC2 display test: Falkon rendered Example Domain in noVNC/scrot capture
PYTHONPATH=$PWD pytest tests/test_desktop_tools.py -q -> 7 passed
PYTHONPATH=$PWD pytest -q -> 365 passed

Fixes the display-browser rendering path after Chrome 148 remained black under the Xvfb/xfce/noVNC display even with GPU/compositor flags. Live finding: - Chrome window existed and was focused, but direct window capture was all black. - Falkon rendered `https://example.com` correctly in the same Xvfb display. Changes: - expose `falkon` in `desktop_status` - prefer Falkon for `desktop_open_url` when installed - keep Chrome fallback with Xvfb-safe flags - bump runtime patch version to 0.3.2 Verification: - live EC2 display test: Falkon rendered Example Domain in noVNC/scrot capture - `PYTHONPATH=$PWD pytest tests/test_desktop_tools.py -q` -> 7 passed - `PYTHONPATH=$PWD pytest -q` -> 365 passed

hongming added 1 commit 2026-05-25 12:33:39 +00:00

fix: prefer falkon for xvfb desktop browsing

ci / lint (pull_request) Successful in 47s

Details

Secret scan / Scan diff for credential-shaped strings (pull_request) Successful in 8s

Details

ci / unit-tests (pull_request) Successful in 1m24s

Details

ci / smoke-install (pull_request) Successful in 1m25s

Details

ci / build (pull_request) Successful in 1m28s

Details