feat(macos): add liquid glass effect support (#191)

ahonn · FabianLars · web-flow · commit 517860970aef · 2025-11-12T10:05:45.000+01:00
Co-authored-by: FabianLars &lt;github@fabianlars.de&gt;
diff --git a/.changes/macos-liquid-glass.md b/.changes/macos-liquid-glass.md
@@ -0,0 +1,5 @@
+---
+"window-vibrancy": "patch:enhance"
+---
+
+Introduce macOS liquid glass support with `apply_liquid_glass` / `clear_liquid_glass`.
diff --git a/.changes/msrv-177.md b/.changes/msrv-177.md
@@ -0,0 +1,5 @@
+---
+window-vibrancy: minor:misc
+---
+
+Increased the MSRV to `1.77`.
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
@@ -23,7 +23,7 @@ jobs:
           sudo apt-get update
           sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.1-dev
 
-      - uses: dtolnay/rust-toolchain@1.71
+      - uses: dtolnay/rust-toolchain@1.77
       - run: cargo build
 
       - uses: dtolnay/rust-toolchain@stable
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -4,7 +4,7 @@ description = "Make your windows vibrant."
 authors = ["Tauri Programme within The Commons Conservancy"]
 version = "0.6.0"
 edition = "2021"
-rust-version = "1.71"
+rust-version = "1.77"
 license = "Apache-2.0 OR MIT"
 readme = "README.md"
 repository = "https://github.com/tauri-apps/tauri-plugin-vibrancy"
@@ -38,20 +38,23 @@ features = [
 ]
 
 [target.'cfg(target_os = "macos")'.dependencies]
-objc2 = "0.6.0"
-objc2-app-kit = { version = "0.3.0", default-features = false, features = [
+objc2 = "0.6"
+objc2-app-kit = { version = "0.3", default-features = false, features = [
   "std",
+  "objc2-core-foundation",
   "NSApplication",
+  "NSColor",
+  "NSGlassEffectView",
   "NSGraphics",
   "NSResponder",
   "NSView",
   "NSVisualEffectView",
 ] }
-objc2-foundation = { version = "0.3.0", default-features = false, features = [
+objc2-foundation = { version = "0.3", default-features = false, features = [
   "std",
   "NSThread",
   "NSGeometry",
 ] }
-objc2-core-foundation = { version = "0.3.0", default-features = false, features = [
+objc2-core-foundation = { version = "0.3", default-features = false, features = [
   "std",
 ] }
diff --git a/examples/tao.rs b/examples/tao.rs
@@ -30,8 +30,10 @@ fn main() {
         .expect("Unsupported platform! 'apply_blur' is only supported on Windows");
 
     #[cfg(target_os = "macos")]
-    apply_vibrancy(&window, NSVisualEffectMaterial::HudWindow, None, None)
-        .expect("Unsupported platform! 'apply_vibrancy' is only supported on macOS");
+    {
+        apply_liquid_glass(&window, NSGlassEffectViewStyle::Clear, None, Some(26.0))
+            .expect("Unsupported platform! 'apply_liquid_glass' is only supported on macOS 26+");
+    }
 
     #[cfg(target_os = "windows")]
     window.set_undecorated_shadow(true);
diff --git a/examples/tauri/package.json b/examples/tauri/package.json
@@ -9,6 +9,6 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@tauri-apps/cli": "^1.0.0"
+    "@tauri-apps/cli": "^2.9.0"
   }
 }
diff --git a/examples/tauri/public/index.html b/examples/tauri/public/index.html
@@ -10,12 +10,14 @@
     html,
     body {
       background: transparent;
+      width: 100vw;
+      height: 100vh;
+      overflow: hidden;
     }
   </style>
 </head>
 
-<body>
-  <div>window vibrancy example</div>
+<body data-tauri-drag-region>
 </body>
 
-</html>
+</html>
diff --git a/examples/tauri/src-tauri/Cargo.toml b/examples/tauri/src-tauri/Cargo.toml
@@ -7,7 +7,7 @@ license = "MIT OR Apache-2.0"
 edition = "2021"
 
 [build-dependencies]
-tauri-build = { version = "2.0.0-beta" }
+tauri-build = { version = "2.0.0-beta", features = [] }
 
 [dependencies]
 serde_json = "1"
diff --git a/examples/tauri/src-tauri/capabilities/default.json b/examples/tauri/src-tauri/capabilities/default.json
@@ -0,0 +1,6 @@
+{
+  "identifier": "main-capability",
+  "description": "Capability for the main window",
+  "windows": ["main"],
+  "permissions": ["core:window:allow-start-dragging"]
+}
diff --git a/examples/tauri/src-tauri/src/main.rs b/examples/tauri/src-tauri/src/main.rs
@@ -16,8 +16,12 @@ fn main() {
             let window = app.get_webview_window("main").unwrap();
 
             #[cfg(target_os = "macos")]
-            apply_vibrancy(&window, NSVisualEffectMaterial::HudWindow, None, None)
-                .expect("Unsupported platform! 'apply_vibrancy' is only supported on macOS");
+            {
+                apply_liquid_glass(&window, NSGlassEffectViewStyle::Clear, None, Some(26.0))
+                    .expect(
+                        "Unsupported platform! 'apply_liquid_glass' is only supported on macOS 26+",
+                    );
+            }
 
             #[cfg(target_os = "windows")]
             apply_blur(&window, Some((18, 18, 18, 125)))
diff --git a/examples/tauri/src-tauri/tauri.conf.json b/examples/tauri/src-tauri/tauri.conf.json
@@ -7,7 +7,16 @@
   },
   "app": {
     "withGlobalTauri": true,
-    "windows": [{ "decorations": false, "transparent": true }],
+    "windows": [{
+      "transparent": true,
+      "titleBarStyle": "Overlay",
+      "decorations": true,
+      "hiddenTitle": true,
+      "trafficLightPosition": {
+        "x": 20,
+        "y": 22
+      }
+    }],
     "macOSPrivateApi": true,
     "security": {
       "csp": null
diff --git a/examples/winit.rs b/examples/winit.rs
@@ -30,8 +30,10 @@ fn main() {
         .expect("Unsupported platform! 'apply_blur' is only supported on Windows");
 
     #[cfg(target_os = "macos")]
-    apply_vibrancy(&window, NSVisualEffectMaterial::HudWindow, None, None)
-        .expect("Unsupported platform! 'apply_vibrancy' is only supported on macOS");
+    {
+        apply_liquid_glass(&window, NSGlassEffectViewStyle::Clear, None, Some(26.0))
+            .expect("Unsupported platform! 'apply_liquid_glass' is only supported on macOS 26+");
+    }
 
     #[cfg(target_os = "windows")]
     window.set_undecorated_shadow(true);
diff --git a/src/lib.rs b/src/lib.rs
@@ -26,10 +26,10 @@
 mod macos;
 mod windows;
 
-pub use macos::{NSVisualEffectMaterial, NSVisualEffectState};
+pub use macos::{NSGlassEffectViewStyle, NSVisualEffectMaterial, NSVisualEffectState};
 
 #[cfg(target_os = "macos")]
-pub use macos::NSVisualEffectViewTagged;
+pub use macos::{NSGlassEffectViewTagged, NSVisualEffectViewTagged};
 
 /// a tuple of RGBA colors. Each value has minimum of 0 and maximum of 255.
 pub type Color = (u8, u8, u8, u8);
@@ -254,6 +254,61 @@ pub fn clear_vibrancy(window: impl raw_window_handle::HasWindowHandle) -> Result
     }
 }
 
+/// Applies liquid glass effect to window. Works only on macOS 26.0+.
+///
+/// ## Platform-specific
+///
+/// - **Linux / Windows**: Unsupported.
+///
+/// # Example
+///
+/// ```no_run
+/// use window_vibrancy::{apply_liquid_glass, NSGlassEffectViewStyle};
+///
+/// # let window: &dyn raw_window_handle::HasWindowHandle = unsafe { std::mem::zeroed() };
+/// apply_liquid_glass(&window, NSGlassEffectViewStyle::Regular, None, Some(12.0));
+/// ```
+#[cfg(target_os = "macos")]
+pub fn apply_liquid_glass(
+    window: impl raw_window_handle::HasWindowHandle,
+    #[allow(unused)] style: NSGlassEffectViewStyle,
+    #[allow(unused)] tint_color: Option<Color>,
+    #[allow(unused)] radius: Option<f64>,
+) -> Result<(), Error> {
+    match window.window_handle()?.as_raw() {
+        #[cfg(target_os = "macos")]
+        raw_window_handle::RawWindowHandle::AppKit(handle) => unsafe {
+            macos::apply_liquid_glass(handle.ns_view, style, tint_color, radius)
+        },
+        _ => Err(Error::UnsupportedPlatform(
+            "\"apply_vibrancy()\" is only supported on macOS.",
+        )),
+    }
+}
+
+/// Clears liquid glass effect applied to window. Works only on macOS 26.0+.
+///
+/// ## Platform-specific
+///
+/// - **Linux / Windows**: Unsupported.
+///
+/// # Returns
+///
+/// - `Ok(true)` if the liquid glass effect was cleared
+/// - `Ok(false)` if the liquid glass effect was not previously applied by this crate.
+#[cfg(target_os = "macos")]
+pub fn clear_liquid_glass(window: impl raw_window_handle::HasWindowHandle) -> Result<bool, Error> {
+    match window.window_handle()?.as_raw() {
+        #[cfg(target_os = "macos")]
+        raw_window_handle::RawWindowHandle::AppKit(handle) => unsafe {
+            macos::clear_liquid_glass(handle.ns_view)
+        },
+        _ => Err(Error::UnsupportedPlatform(
+            "\"clear_liquid_glass()\" is only supported on macOS.",
+        )),
+    }
+}
+
 #[derive(Debug)]
 pub enum Error {
     UnsupportedPlatform(&'static str),
diff --git a/src/macos/liquid_glass.rs b/src/macos/liquid_glass.rs
@@ -0,0 +1,74 @@
+use std::{ffi::c_void, ptr::NonNull};
+
+use objc2::MainThreadMarker;
+use objc2_app_kit::{
+    NSAppKitVersionNumber, NSAutoresizingMaskOptions, NSColor, NSGlassEffectViewStyle, NSView,
+    NSWindowOrderingMode,
+};
+use objc2_foundation::NSInteger;
+
+use crate::{macos::ns_glass_effect_view_tagged::NSGlassEffectViewTagged, Error};
+
+/// NSView::tag for NSVisualEffectViewTagged, just a random number
+pub const NS_VIEW_TAG_GLASS_VIEW: NSInteger = 96945937;
+
+pub unsafe fn apply_liquid_glass(
+    ns_view: NonNull<c_void>,
+    style: super::NSGlassEffectViewStyle,
+    tint_color: Option<crate::Color>,
+    radius: Option<f64>,
+) -> Result<(), Error> {
+    let mtm = MainThreadMarker::new().ok_or(Error::NotMainThread(
+        "\"apply_liquid_glass()\" can only be used on the main thread.",
+    ))?;
+
+    let tint_color = tint_color.map(|(r, g, b, a)| {
+        NSColor::colorWithRed_green_blue_alpha(
+            r as f64 / 255.0,
+            g as f64 / 255.0,
+            b as f64 / 255.0,
+            a as f64 / 255.0,
+        )
+    });
+
+    unsafe {
+        let view: &NSView = ns_view.cast().as_ref();
+
+        if NSAppKitVersionNumber < 2685.0 {
+            return Err(Error::UnsupportedPlatformVersion(
+                "\"apply_liquid_glass()\" is only available on macOS 26.0 or newer.",
+            ));
+        }
+
+        let s = NSGlassEffectViewStyle(style as isize);
+
+        let bounds = view.bounds();
+        let glass_view =
+            NSGlassEffectViewTagged::initWithFrame(mtm.alloc(), bounds, NS_VIEW_TAG_GLASS_VIEW);
+
+        glass_view.setStyle(s);
+        glass_view.setCornerRadius(radius.unwrap_or(0.0));
+        glass_view.setTintColor(tint_color.as_deref());
+
+        glass_view.setAutoresizingMask(
+            NSAutoresizingMaskOptions::ViewWidthSizable
+                | NSAutoresizingMaskOptions::ViewHeightSizable,
+        );
+
+        view.addSubview_positioned_relativeTo(&glass_view, NSWindowOrderingMode::Below, None);
+    }
+
+    Ok(())
+}
+
+pub unsafe fn clear_liquid_glass(ns_view: NonNull<c_void>) -> Result<bool, Error> {
+    let view: &NSView = ns_view.cast().as_ref();
+    let glass_view = view.viewWithTag(NS_VIEW_TAG_GLASS_VIEW);
+
+    if let Some(glass_view) = glass_view {
+        glass_view.removeFromSuperview();
+        return Ok(true);
+    }
+
+    Ok(false)
+}
diff --git a/src/macos/mod.rs b/src/macos/mod.rs
diff --git a/src/macos/ns_glass_effect_view_tagged.rs b/src/macos/ns_glass_effect_view_tagged.rs
diff --git a/src/macos/vibrancy.rs b/src/macos/vibrancy.rs

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +"window-vibrancy": "patch:enhance"
 +---
++
 +Introduce macOS liquid glass support with `apply_liquid_glass` / `clear_liquid_glass`.
Original file line number	Diff line number	Diff line change
`@@ -9,6 +9,6 @@`
`9`	`9`	`"author": "",`
`10`	`10`	`"license": "MIT",`
`11`	`11`	`"dependencies": {`
`12`		`- "@tauri-apps/cli": "^1.0.0"`
	`12`	`+ "@tauri-apps/cli": "^2.9.0"`
`13`	`13`	`}`
`14`	`14`	`}`