Skip to content
CC Switch WikiUnofficial Community Wiki

The interface does not refresh by itself; only dragging the window triggers a UI redraw - cc-switch

Quick fix

Upgrade to v3.13.0+ for the Linux interface freeze fix; the Windows built-in Administrator needs a registry change to open the main window.

Symptom

Section titled “Symptom”
Error output
界面不会自动刷新，只有手动拖动窗口才会触发 UI 重绘
English translation

The interface does not refresh by itself; only dragging the window by hand triggers a UI redraw

Cause

Section titled “Cause”

This mostly comes from rendering event compatibility defects between Tauri 2 and WebKitGTK on some Linux distributions (Debian 13, Ubuntu 24.04), which freeze the app when clicking an input box or leave an initial white screen. It was resolved officially in v3.13.0 by building in WEBKIT_DISABLE_COMPOSITING_MODE=1 and adding a focus fix function. There is another variant on Windows: using the system built-in Administrator account, Evergreen WebView2 initialisation fails on the permission context and the main window will not open at all.

Fix

Section titled “Fix”

  1. Linux users: upgrade cc-switch to v3.13.0 or newer, which fixed the UI responsiveness systematically.

  2. If you cannot upgrade on Linux yet, try disabling compositing mode at launch by hand: WEBKIT_DISABLE_COMPOSITING_MODE=1 ./cc-switch.

  3. Linux stopgap: when the interface freezes or goes white, dragging to resize the window repeatedly forces a UI redraw. You can also try enabling the Linux native title bar in settings.

  4. Windows users whose main window will not open: if you use the built-in Administrator account, change the registry to enable UAC filtering and restart.

    HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System
    FilterAdministratorToken = 1

  5. Windows alternative: point at a fixed-version WebView2 through an environment variable (set WEBVIEW2_BROWSER_EXECUTABLE_FOLDER=<fixed-version WebView2 directory>), or sign in with an ordinary administrator account.

Affected Versions

Section titled “Affected Versions”
Toolcc-switch
Version3.11.1 - 3.15.0
PlatformsLinuxWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 3 real issues

FAQ

Section titled “FAQ”
Why does clicking to edit text freeze the interface on Ubuntu 24.04?
WebKitGTK rendering events do not fire correctly. Upgrade to v3.13.0 or newer, where this was fixed officially.
The tray icon works on Windows but clicking to open the main window does nothing. What now?
If you use the Windows built-in Administrator account, WebView2 fails to initialise. Change the registry to set FilterAdministratorToken to 1 and restart, or create an ordinary administrator account and use that.
Setting WEBKIT_DISABLE_COMPOSITING_MODE=1 on Linux still freezes. What now?
Try enabling the Linux native title bar in cc-switch settings, or use the community CLI build (cc-switch-cli) instead.
Section titled “Related problems”
Main window completely blank (pure white)Set WEBKIT_DISABLE_DMABUF_RENDERER=0 to restore normal rendering under WebKitGTK 2.52 + Mesa.2 issues mergedcc-switch white screen / black screen / crash / no window on launchWork out whether it is corrupt window state, a WebView2/OS compatibility problem, or security software. Handle per symptom; use the CLI build if needed.14 issues mergedEGL_BAD_PARAMETER white screen error - cc-switchInstall the native .deb or AUR package instead, or run the AppImage with LD_PRELOAD pointing at the system library, to resolve the ABI conflict.6 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.