Flatpak Application Launch Failure Report #332
Description
Application: net.mkiol.SpeechNote (Flatpak)
User Environment: GNOME 46 on Ubuntu 24.04
Failure Behavior: The application launches successfully but crashes immediately after the user clicks on the window or attempts any interaction.
Problem Details
The issue appears to be related to how the application attempts to connect to the display server, specifically within a Wayland environment (the default display protocol on GNOME 46 in Ubuntu 24.04).
The application was failing when trying to utilize Wayland (or the XWayland compatibility layer) for rendering and user interaction.
Resolution Command
The problem was resolved by forcing the application to use the X11 display protocol within the Flatpak sandbox.
The command that fixed the crash was:
sudo flatpak override net.mkiol.SpeechNote –socket=x11 –nosocket=wayland
This command:
Revokes the permission to use the Wayland socket (--nosocket=wayland).
Grants the permission to use the X11 socket (--socket=x11).
After applying this override, the application launched and functioned correctly, confirming that the failure was linked to the display protocol stack.
Suggested Action for the Developer
To ensure the application runs natively and stably on modern Linux environments (like Wayland), we suggest investigating the following areas:
Runtime Check: Confirm the application is packaged and configured to use the latest appropriate Flatpak runtime (GNOME, KDE, etc.) that offers robust Wayland support.
Library Configuration: If the application is based on Qt, verify that the libraries are correctly configured for the Wayland backend (e.g., using qt6-wayland or equivalent dependencies).
Failure Logs: If possible, add logging to capture information during the Wayland startup attempt. This may reveal the specific exception that is causing the abrupt crash/closure.
The failure to initialize using the Wayland/XWayland protocol is the primary cause identified.