Skip to content
CC Switch WikiUnofficial Community Wiki

EGL_BAD_PARAMETER white screen error - cc-switch

Quick fix

Install the native .deb or AUR package instead, or run the AppImage with LD_PRELOAD pointing at the system library, to resolve the ABI conflict.

Symptom

Section titled “Symptom”
Error output
Could not create default EGL display: EGL_BAD_PARAMETER. Aborting...

Cause

Section titled “Cause”

The problem comes from the WebKitGTK, GTK, or GLib libraries bundled in the AppImage conflicting at the ABI level with the host system's newer display server protocol (Wayland/X11), graphics driver, or system libraries. When WebKitGTK tries to create a default display through the host's Mesa/EGL libraries, mismatched parameters or environment make the initialisation fail, hanging the render process, whiting out the interface, and throwing this error. On newer distributions such as Ubuntu 26.04 it is also accompanied by GIO module load failures, because the bundled older GLib is incompatible with the host GVFS modules.

Fix

Section titled “Fix”

  1. Install the native package (recommended): uninstall the AppImage and install the .deb package or AUR (cc-switch-bin). A native package calls the host system's WebKitGTK and GLib directly, avoiding the ABI conflict entirely.

  2. Preload the system library with LD_PRELOAD: if you must use the AppImage, preload the host Wayland client library in a terminal to work around the conflict, for example LD_PRELOAD=/usr/lib/libwayland-client.so ./CC-Switch-v3.17.0-Linux-x86_64.AppImage.

  3. Use the CLI build: if the GUI problem cannot be resolved on your distribution, use the headless command-line build cc-switch-cli.

Affected Versions

Section titled “Affected Versions”
Toolcc-switch
Version3.8.3 - 3.19.0
PlatformsLinux

Source Issues

Section titled “Source Issues”

This page is distilled from 6 real issues

FAQ

Section titled “FAQ”
Why do I still see undefined symbol: g_task_set_static_name on newer systems such as Ubuntu 26.04?
Because the AppImage bundles older GLib/GIO libraries that are ABI-incompatible with the host system's newer GVFS modules. Switching to the .deb package resolves it.
The interface feels sluggish after starting with LD_PRELOAD. What now?
Preloading system libraries can cost performance. Install the native build through AUR (cc-switch-bin) or the .deb package for the smoothest result.
Section titled “Related problems”
"event handler is re-entrant" error or startup crashUninstall Windows update KB5081263 or wait for cc-switch upgrade to avoid crashes and UI rendering failures caused by TAO EventLoop re-entry.2 issues mergedGtk-CRITICAL: gtk_widget_get_scale_factor failedOn a GTK assertion failure running cc-switch under Linux or WSL2, edit settings.json to turn silent startup off, or clean the leftovers and reinstall.3 issues mergedWarmup request downgraded to modelTurn the Copilot warmupDowngrade option off in CC Switch so requests are not silently replaced with gpt-5-mini.5 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.