fix(player): stabilize NVIDIA Wayland WebKit startup - #65
Open
LuorixDev wants to merge 5 commits into
Open
Conversation
LuorixDev
marked this pull request as ready for review
July 31, 2026 10:09
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
~/.config/net.stevexmh.amllplayer/linux-webview.json(or$XDG_CONFIG_HOME/net.stevexmh.amllplayer/linux-webview.json);AMLL_LINUX_WEBVIEW_BACKENDremains an explicit override.AMLL_XEPHYR_FPSfor explicit high-refresh testing.Why
Native WebKitGTK can terminate with a Wayland protocol error or lose rendered content on NVIDIA Wayland. The nested X11 path avoids that failure, but it has different window-management behavior and must not be silently selected for every Linux installation.
The first-run confirmation is displayed in a temporary compatibility session because the native WebView may fail before it can render a prompt. Choosing
openboxkeeps the compatibility backend; choosingsystemrestarts into the original environment.User impact
The wrapper code and dependencies compile only on Linux. Non-Linux platforms retain the original window and WebView path. Linux users can edit the saved
backendvalue toopenbox,system,x11,wayland,wayland-software, orauto.Validation
cargo test -p amll-player --lib linux_webview::tests(12 passed)cargo build -p amll-playerpnpm --filter player buildgit diff --checkKnown limitation
Xephyr adds a CPU copy/compositing stage because it does not expose DRI3 to nested clients. WebKitGTK can still use the GPU, but this is not equivalent to native Wayland performance.