The interface is completely blank - cc-switch
Quick fix
Upgrade cc-switch to the latest version, which disables DMABUF rendering by default, or use the CLI build to resolve the Tauri 2 white screen.
Symptom
Section titled “Symptom”界面一片空白The interface is completely blank
cc-switch has used Tauri 2 since version 3.7, which is relatively demanding about the OS version. On an older system (Debian 13.2, macOS 11.6), the WebKit DMABUF renderer stops the graphical interface rendering, showing a blank interface or unrendered CSS. Early versions also reset the shortcut config on every launch, so environment variables you added by hand stopped applying.
Upgrade cc-switch to the latest version. Maintainers adjusted the write logic to set WEBKIT_DISABLE_DMABUF_RENDERER=1 in the environment variables by default and fixed the shortcut being reset.
If your OS is too old to run the graphical interface, use the CLI build cc-switch-cli instead.
On Linux, you can work around the rendering by editing the shortcut file and adding the environment variable before the launch command.
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”This page is distilled from 2 real issues
- Why do the environment variables I added to the shortcut stop applying after a restart?
- Older cc-switch resets the shortcut config to its original values on every launch. Upgrade to the latest version, where this is fixed and the program carries the environment variable configuration itself.
- I tried versions 3.3 to 3.5 on macOS 11.6 and it still will not render. What now?
- Your OS version is too old for Tauri 2. Upgrade the operating system, or use the cc-switch-cli command-line build.
Related problems
Section titled “Related problems”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.