From 1b30e30ba775464f85d1f255f9ee22c546fae2fe Mon Sep 17 00:00:00 2001 From: Mooneer Salem Date: Tue, 10 Jun 2025 08:25:09 -0700 Subject: [PATCH] Add note about using XWayland on Linux. (#926) * Add note about using XWayland on Linux. * Add PR #926 to changelog. --- README.md | 5 +++++ USER_MANUAL.md | 1 + 2 files changed, 6 insertions(+) diff --git a/README.md b/README.md index a8de46ae..64b0e372 100644 --- a/README.md +++ b/README.md @@ -79,9 +79,14 @@ This document describes how to build the FreeDV GUI program for various operatin ``` (rade-venv) $ pwd /home//freedv-gui/build_linux + (rade-venv) $ export GDK_BACKEND=x11 # optional, see (*) below (rade-venv) $ PYTHONPATH="$(pwd)/rade_src:$PYTHONPATH" src/freedv ``` +(*) If your Linux distribution and/or desktop environment uses Wayland, FreeDV will always open in the middle +of the screen, regardless of where you positioned it before. You can avoid this by having FreeDV run as an +X11 application instead using XWayland (`GDK_BACKEND=x11`). + Alternatively, you can use [this script](https://github.com/barjac/freedv-rade-build) developed by Barry Jackson G4MKT to automate the above steps. While the FreeDV project thanks him for his contribution to helping Linux users more easily get on the air with FreeDV, the FreeDV development team will not provide diff --git a/USER_MANUAL.md b/USER_MANUAL.md index 0ae2a66c..d5a2a815 100644 --- a/USER_MANUAL.md +++ b/USER_MANUAL.md @@ -802,6 +802,7 @@ LDPC | Low Density Parity Check Codes - a family of powerful FEC codes * Fix WASAPI errors on some machines by supporting audio mix formats other than 16-bit integer. (PR #919) 2. Documentation: * Add missing dependency for macOS builds to README. (PR #925; thanks @relistan!) + * Add note about using XWayland on Linux. (PR #926) ## V2.0.0 June 2025