From 41e865c8d35468c67b991ef5a245a98b3e44108c Mon Sep 17 00:00:00 2001 From: Shawn Wallace Date: Tue, 2 Sep 2025 23:11:56 -0400 Subject: [PATCH] Document _JAVA_AWT_WM_NONREPARENTING Closes #231 --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index fdf5748..9b2570c 100644 --- a/README.md +++ b/README.md @@ -16,6 +16,10 @@ Need help troubleshooting, or have some other general question? [Ask on GitHub D Run `xwayland-satellite`. You can specify an X display to use (i.e. `:12`). Be sure to set the same `DISPLAY` environment variable for any X11 clients. Because xwayland-satellite is a Wayland client (in addition to being a Wayland compositor), it will need to launch after your compositor launches, but obviously before any X11 applications. +## Java applications +Some (most?) Java applications may present themselves as a blank screen by default with satellite. To fix this, simply set the environment variable +`_JAVA_AWT_WM_NONREPARENTING=1` before launching it to fix this. Unfortunately there is not a way for satellite to automatically do this. + ## Building ``` # dev build