feature: supports to disable Mica effect on Windows 11 from theme overrides (#2191)

love-linger · love-linger · commit 14db2d5cb053 · 2026-03-16T11:53:26.000+08:00
Add `UseMicaOnWindows11` to custom theme schema

Signed-off-by: leo &lt;longshuang@msn.cn&gt;
diff --git a/src/App.axaml.cs b/src/App.axaml.cs
@@ -286,6 +286,8 @@ public static void SetTheme(string theme, string themeOverridesFile)
                     else
                         Models.CommitGraph.SetDefaultPens(overrides.GraphPenThickness);
 
+                    Native.OS.UseMicaOnWindows11 = overrides.UseMicaOnWindows11;
+
                     app.Resources.MergedDictionaries.Add(resDic);
                     app._themeOverrides = resDic;
                 }
diff --git a/src/Models/ThemeOverrides.cs b/src/Models/ThemeOverrides.cs
@@ -9,6 +9,7 @@ public class ThemeOverrides
         public Dictionary<string, Color> BasicColors { get; set; } = new Dictionary<string, Color>();
         public double GraphPenThickness { get; set; } = 2;
         public double OpacityForNotMergedCommits { get; set; } = 0.5;
+        public bool UseMicaOnWindows11 { get; set; } = true;
         public List<Color> GraphColors { get; set; } = new List<Color>();
     }
 }
diff --git a/src/Native/OS.cs b/src/Native/OS.cs
@@ -107,6 +107,12 @@ public static string ExternalDiffArgs
             set;
         } = string.Empty;
 
+        public static bool UseMicaOnWindows11
+        {
+            get => OperatingSystem.IsWindows() && OperatingSystem.IsWindowsVersionAtLeast(10, 0, 22000) && _enableMicaOnWindows11;
+            set => _enableMicaOnWindows11 = value;
+        }
+
         public static bool UseSystemWindowFrame
         {
             get => OperatingSystem.IsLinux() && _enableSystemWindowFrame;
@@ -294,5 +300,6 @@ private static void UpdateGitVersion()
         private static IBackend _backend = null;
         private static string _gitExecutable = string.Empty;
         private static bool _enableSystemWindowFrame = false;
+        private static bool _enableMicaOnWindows11 = true;
     }
 }
diff --git a/src/Views/Launcher.axaml.cs b/src/Views/Launcher.axaml.cs
@@ -62,7 +62,7 @@ public Launcher()
             InitializeComponent();
             PositionChanged += OnPositionChanged;
 
-            if (OperatingSystem.IsWindows() && OperatingSystem.IsWindowsVersionAtLeast(10, 0, 22000))
+            if (Native.OS.UseMicaOnWindows11)
             {
                 Background = Brushes.Transparent;
                 TransparencyLevelHint = [WindowTransparencyLevel.Mica];

Original file line number	Diff line number	Diff line change
`@@ -286,6 +286,8 @@ public static void SetTheme(string theme, string themeOverridesFile)`
`286`	`286`	`else`
`287`	`287`	`Models.CommitGraph.SetDefaultPens(overrides.GraphPenThickness);`
`288`	`288`
	`289`	`+ Native.OS.UseMicaOnWindows11 = overrides.UseMicaOnWindows11;`
	`290`	`+`
`289`	`291`	`app.Resources.MergedDictionaries.Add(resDic);`
`290`	`292`	`app._themeOverrides = resDic;`
`291`	`293`	`}`
Original file line number	Diff line number	Diff line change
`@@ -9,6 +9,7 @@ public class ThemeOverrides`
`9`	`9`	`public Dictionary<string, Color> BasicColors { get; set; } = new Dictionary<string, Color>();`
`10`	`10`	`public double GraphPenThickness { get; set; } = 2;`
`11`	`11`	`public double OpacityForNotMergedCommits { get; set; } = 0.5;`
	`12`	`+ public bool UseMicaOnWindows11 { get; set; } = true;`
`12`	`13`	`public List<Color> GraphColors { get; set; } = new List<Color>();`
`13`	`14`	`}`
`14`	`15`	`}`
Original file line number	Diff line number	Diff line change
`@@ -107,6 +107,12 @@ public static string ExternalDiffArgs`
`107`	`107`	`set;`
`108`	`108`	`} = string.Empty;`
`109`	`109`
	`110`	`+ public static bool UseMicaOnWindows11`
	`111`	`+ {`
	`112`	`+ get => OperatingSystem.IsWindows() && OperatingSystem.IsWindowsVersionAtLeast(10, 0, 22000) && _enableMicaOnWindows11;`
	`113`	`+ set => _enableMicaOnWindows11 = value;`
	`114`	`+ }`
	`115`	`+`
`110`	`116`	`public static bool UseSystemWindowFrame`
`111`	`117`	`{`
`112`	`118`	`get => OperatingSystem.IsLinux() && _enableSystemWindowFrame;`
`@@ -294,5 +300,6 @@ private static void UpdateGitVersion()`
`294`	`300`	`private static IBackend _backend = null;`
`295`	`301`	`private static string _gitExecutable = string.Empty;`
`296`	`302`	`private static bool _enableSystemWindowFrame = false;`
	`303`	`+ private static bool _enableMicaOnWindows11 = true;`
`297`	`304`	`}`
`298`	`305`	`}`
Original file line number	Diff line number	Diff line change
`@@ -62,7 +62,7 @@ public Launcher()`
`62`	`62`	`InitializeComponent();`
`63`	`63`	`PositionChanged += OnPositionChanged;`
`64`	`64`
`65`		`- if (OperatingSystem.IsWindows() && OperatingSystem.IsWindowsVersionAtLeast(10, 0, 22000))`
	`65`	`+ if (Native.OS.UseMicaOnWindows11)`
`66`	`66`	`{`
`67`	`67`	`Background = Brushes.Transparent;`
`68`	`68`	`TransparencyLevelHint = [WindowTransparencyLevel.Mica];`