From 456a886a333a494b2929819ba7648a63cf65aeb1 Mon Sep 17 00:00:00 2001 From: OpenSauce04 Date: Fri, 5 Dec 2025 16:38:54 +0000 Subject: [PATCH] Updated Linux section of readme with Wayland information --- README.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index db4aa84f4..8a7e32c9e 100644 --- a/README.md +++ b/README.md @@ -19,7 +19,6 @@ Download the latest release from [Releases](https://github.com/azahar-emu/azahar If you are unsure of whether you want to use MSYS2 or MSVC, use MSYS2. --- - ### MacOS To download a build that will work on all Macs, you can download the `macos-universal` build on the [Releases](https://github.com/azahar-emu/azahar/releases) page. @@ -55,6 +54,11 @@ The recommended format for using Azahar on Linux is the Flatpak available on Fla Azahar is also available as an AppImage on the [Releases](https://github.com/azahar-emu/azahar/releases) page. +If you are unsure of which variant to use, we recommend using the default `azahar.AppImage`. This is because of upstream issues in the Wayland ecosystem which may cause problems when running the emulator (e.g. [#1162](https://github.com/azahar-emu/azahar/issues/1162)). + +Unless you explicitly require native Wayland support (e.g. you are running a system with no Xwayland), the non-Wayland variant is recommended. + +If you are using the Flatpak and run into issues with Wayland, you can disable Wayland support for the Azahar Flatpak using [Flatseal](https://flathub.org/en/apps/com.github.tchx84.Flatseal). # Build instructions