Skip to content
CC Switch WikiUnofficial Community Wiki

UI freezes after clicking any input field - cc-switch

Quick fix

Set WEBKIT_DISABLE_COMPOSITING_MODE=1 or upgrade to v3.14.1 and enable the native title bar to fix Linux UI freezes and unresponsive buttons.

Symptom

Section titled “Symptom”
Error output
这个环境下，点击任意的输入框都会卡死，但点击仍然能感觉有按钮反馈（看鼠标图标的话），但视窗不会有任何变化
English translation

In this environment, clicking any input field freezes the UI. Clicks still appear to produce button feedback based on the mouse cursor, but the window does not change.

Cause

Section titled “Cause”

Tauri webview has focus acquisition and rendering problems on Linux. WebKitGTK 2.40+ has known rendering and input defects that can freeze the UI after clicking an input field. In addition, the GTK surface input region is not renegotiated when the window is shown, causing title bar and window decoration areas to lose focus and stop responding to mouse events.

Fix

Section titled “Fix”

  1. Before launching the app, set the environment variable to disable WebKitGTK compositing mode: export WEBKIT_DISABLE_COMPOSITING_MODE=1. If that does not work, also try export WEBKIT_DISABLE_DMABUF_RENDERER=1, or run both together: WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 ./cc-switch.

  2. For unclickable title bar buttons, upgrade to v3.14.1 and enable “Enable app-level window buttons” (native title bar option) in the app.

Affected Versions

Section titled “Affected Versions”
Toolcc-switch
Version3.8.2 - 3.13.0 (受影响版本)，v3.14.1 修复了标题栏问题
PlatformsLinux

Source Issues

Section titled “Source Issues”

This page is distilled from 2 real issues

FAQ

Section titled “FAQ”
What if the UI still freezes after setting the environment variable?
Try setting both environment variables together: WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 ./cc-switch. If it still fails, temporarily use the cc-switch CLI version.
Title bar buttons are still unclickable after upgrading to v3.13.0?
The v3.13.0 fix does not fully resolve this issue. Upgrade to v3.14.1 and enable the “Enable app-level window buttons” option in the app.
Section titled “Related problems”
config.toml quietly reverts to the earlier configurationThe cc-switch database is the single source of truth. Hand edits to local files are overwritten — change things in the MCP manager or general config instead.6 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 mergedThe interface is completely blank - cc-switchUpgrade cc-switch to the latest version, which disables DMABUF rendering by default, or use the CLI build to resolve the Tauri 2 white screen.2 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.