A humble suggestion :

[snoovocz]

it would be better if u add an executable for linux like a .appimage or something

[nekomeowww]

We used to support Linux, but many bugs were found due to #263. If you use Linux a lot, please help us to debug this.

[snoovocz]

I mean i may have some basic suggestions, u can atleast just try it:

Renderer: Consider switching from WebKitGTK to a Chromium-based backend or add a Tauri plugin for Chromium, since WebKitGTK often breaks WebGL (especially on NVIDIA + Wayland).

Fallback: If the WebGL canvas fails, AIRI could default to a software renderer or simplified 2D mode so at least something shows instead of a blank screen.

Dependencies: AppImage may be missing libwebkit2gtk-4.1, libjavascriptcoregtk-4.1, libappindicator-gtk3, or librsvg2. Bundling those could fix rendering issues on Arch/Fedora.

Wayland/X11: Maybe provide a flag like AIRI_FORCE_X11=1 to bypass buggy Wayland behavior.

Packaging: If AppImage keeps failing, Flatpak might be a good fallback since it handles GTK/WebKit deps better.

These are just ideas, but maybe they help narrow down the root cause 🚀.

Also I’d love to help test builds on Arch Linux if you push experimental ones.

[nekomeowww]

Chromium-based backend

Yes we are planning to move back to Electron based in this way WebGL will not fail.

Tauri plugin for Chromium

This might not be possible for us to make it, webview integration for Tauri is hard.

could default to a software renderer or simplified 2D mode so at least something

Good idea but currently, if WebGL fails, we won't be able to get any error messages, neither warnings or be able to detect whether it renders or not (in memory, or the video frame buffer, pixels exist, it just won't render), I am afraid of this is not possible for us to implement.

Flatpak might be a good fallback since it handles GTK/WebKit deps better.

@leohearts did suggest that. I never tried because I am not that much familiar with Flatpak and building pipelines for Linux. Nix is special, it reproduces stable-ly.

In conclusion, I think we will move to Electron instead of fighting and tricking the rendering layer, if we could have someone who understand WebKit / GTK in community, they are free to try out different setup, we will definitely merge it if possible to workaround.

[snoovocz]

Yeah it would be great, and btw, good luck 👍