Skip to content

fix(appimage): use the host's C++ runtime and GPU libraries - #3

Merged
DariusDev16 merged 1 commit into
mainfrom
fix/appimage-host-gpu-libs
Nov 7, 2026
Merged

DariusDev16 merged 1 commit into
mainfrom
fix/appimage-host-gpu-libs

Conversation

@DariusDev16

Copy link
Copy Markdown
Owner

Problem

Bulk send crashed the AppImage on Debian 13 as soon as the WhatsApp Web window opened.

PyInstaller bundles the build machine's libstdc++.so.6. The copy in the 1.3.0 image only goes up to GLIBCXX_3.4.30, and because it comes first on LD_LIBRARY_PATH, the host's Mesa driver (radeonsi, through libLLVM-19 / libz3, which need GLIBCXX_3.4.31+) can't load. That leaves QtWebEngine with no OpenGL (eglInitialize ... EGL_NOT_INITIALIZED, QRhiGles2: Failed to create context) and the process dies.

The bundled libgbm.so.1 causes a second mismatch with the host's Mesa (did not find extension DRI_Mesa, GBM: Failed to initialize, Compositor returned null texture).

Fix

In build-appimage.sh:

  • delete libstdc++.so.6, libgcc_s.so.1 and libgbm.so.1 from the bundle after PyInstaller runs
  • stop bundling libEGL, libGL, libGLX, libGLdispatch and libdrm

These have to match the host's GPU driver, and every Linux desktop has them (they're on the AppImage excludelist for that reason).

Also adds a Fixed entry under Unreleased in CHANGELOG.md.

Testing

  • Rebuilt with ./build-appimage.sh: the self-test and the CLI self-test pass.
  • With the new bundle on the library path, ldd resolves every dependency of libz3, libLLVM-19 and radeonsi_dri.so (the old bundle left 3 symbol versions unresolved in each).
  • An extracted 1.3.0 image with these libraries removed opened Bulk send without crashing, and WhatsApp Web loaded.
  • Not yet tested: a full bulk send run in the rebuilt AppImage.

🤖 Generated with Claude Code

Bulk send crashed the AppImage on Debian 13. PyInstaller bundled the build
machine's libstdc++ (GLIBCXX up to 3.4.30); it wins on LD_LIBRARY_PATH, so the
host's Mesa driver (libLLVM/libz3 need GLIBCXX_3.4.31+) failed to load,
QtWebEngine got no OpenGL and the app died when WhatsApp Web opened.

- drop libstdc++.so.6, libgcc_s.so.1 and libgbm.so.1 from the bundle
- stop bundling libEGL, libGL, libGLX, libGLdispatch and libdrm

These must match the host's GPU driver and are on every Linux desktop.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@DariusDev16
DariusDev16 merged commit 242d329 into main Nov 7, 2026
3 checks passed
@DariusDev16
DariusDev16 deleted the fix/appimage-host-gpu-libs branch November 7, 2026 16:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants