window-vibrancy

To use window-vibrancy with Tauri, you must configure your frontend and Tauri settings to allow transparency:

1. CSS: Set html, body { background: transparent } in your web assets.
2. tauri.conf.json: Set "transparent": true in your window configuration.
3. macOS specific: Set "macOSPrivateApi": true in your tauri.conf.json.

For macOS 26 and newer, use apply_liquid_glass to achieve a modern glass effect with customizable radius, opacity, and view styles. You can use LiquidGlassOptions to configure the effect.

Advanced WebView Integration: If you are managing the primary content view (e.g., a WKWebView), you can pass its pointer via .content_view(webview) to reparent it into the glass view's contentView.

use window_vibrancy::{apply_liquid_glass, LiquidGlassOptions, NSGlassEffectViewStyle};

#[cfg(target_os = "macos")]
{
    let options = LiquidGlassOptions::new(NSGlassEffectViewStyle::Clear)
        .radius(26.0)
        .opaque(false);

    apply_liquid_glass(&window, options)
        .expect("Unsupported platform! 'apply_liquid_glass' is only supported on macOS 26+");
}

The following functions are available for applying and clearing window effects. Note that some effects may have performance implications during window resizing or dragging.

| Function | Supported platforms | Notes |
|:---|:---|:---|
| `apply_blur` & `clear_blur` | Windows 7/10/11 (22H1 only) | Bad performance when resizing/dragging on Windows 11 build 22621+ |
| `apply_acrylic` & `clear_acrylic` | Windows 10/11 | Bad performance when resizing/dragging on Windows 10 v1903+ and Windows 11 build 22000 |
| `apply_mica` & `clear_mica` | Windows 11 | |
| `apply_vibrancy` & `clear_vibrancy` | macOS 10.10 and newer | |
| `apply_liquid_glass` & `clear_liquid_glass` | macOS 26 and newer | Modern glass effect with customizable radius, tint color, and opacity options |

When using the Liquid Glass API, be aware of the following error conditions:

• Error::NotMainThread: Occurs if apply_liquid_glass is called from a background thread. All macOS UI manipulations must happen on the main thread.
• Error::UnsupportedPlatformVersion: Occurs if the system is running a version of macOS older than 26.0.

Applies the Tabbed effect (optimized for tabbed interfaces) to the specified window.

• Windows 11 (v22523+): Uses DwmSetWindowAttribute with DWMSBT_TABBEDWINDOW.

Parameters:

• hwnd: The window handle.
• dark: An optional boolean to enable/disable immersive dark mode.

Supported Platforms: Windows 11 only.

apply_tabbed(hwnd, Some(false))?

Removes the mica effect from a Windows 11 window.

use window_vibrancy::clear_mica;

clear_mica(&window).expect("Failed to clear mica");

Removes the liquid glass effect from a macOS window. This is only supported on macOS 26.0+.

Returns:

• Ok(true) if the liquid glass effect was cleared.
• Ok(false) if the liquid glass effect was not previously applied by this crate.

// Only available on macOS
#[cfg(target_os = "macos")]
use window_vibrancy::clear_liquid_glass;

let cleared = clear_liquid_glass(&window).expect("Failed to clear liquid glass");

Removes the vibrancy effect from a macOS window. This is only supported on macOS 10.10 or newer.

Returns:

• Ok(true) if the vibrancy effect was cleared.
• Ok(false) if the vibrancy effect was not previously applied by this crate.

use window_vibrancy::clear_vibrancy;

let cleared = clear_vibrancy(&window).expect("Failed to clear vibrancy");

Removes the blur effect from the specified window.

• Windows 7: Disables blur via DwmEnableBlurBehindWindow.
• Windows 10 (v1809+): Disables the accent via SetWindowCompositionAttribute with ACCENT_DISABLED.

Supported Platforms: Windows 7, Windows 10 v1809 or newer, and Windows 11.

clear_blur(hwnd)?

Applies the Mica effect to the specified window.

• Windows 11 (v22523+): Uses DwmSetWindowAttribute with DWMSBT_MAINWINDOW.
• Windows 11 (v22000+): Uses the undocumented DWMWA_MICA_EFFECT attribute.

Parameters:

• hwnd: The window handle.
• dark: An optional boolean to enable/disable immersive dark mode for the effect.

Supported Platforms: Windows 11 only.

apply_mica(hwnd, Some(true))?

Applies the liquid glass effect to a window. This is only supported on macOS 26.0+.

Arguments:

• options: A LiquidGlassOptions<'_> object.

// Only available on macOS
#[cfg(target_os = "macos")]
use window_vibrancy::apply_liquid_glass;

apply_liquid_glass(&window, options).expect("Failed to apply liquid glass");