From d2d5681032de598697ed9e0f86a5b91998097016 Mon Sep 17 00:00:00 2001 From: Laurent Monin Date: Mon, 29 Apr 2024 12:55:46 +0200 Subject: [PATCH] Add a note about Qt6 installed from pip and libxcb errors --- INSTALL.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/INSTALL.md b/INSTALL.md index e2555bb68ea..f3226eb5fc7 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -45,6 +45,26 @@ The binaries for Python, GetText (`msgfmt`), `fpcalc` and `discid.dll` have to b in the `%PATH%` on Windows. +Note about Qt6 installed via pip: +--------------------------------- + +If you get errors related to `libxcb` on application startup, you may need to install extra librairies on your system. + +Typical error looks like: + +``` +qt.qpa.plugin: From 6.5.0, xcb-cursor0 or libxcb-cursor0 is needed to load the Qt xcb platform plugin. +qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found. +This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem. +``` + +In this case, you have to install extra packages system-wide, for example, in this case, on Ubuntu: + +```bash +sudo apt install libxcb-cursor0 +``` + + Installation using pip ----------------------