window-vibrancy

Make your windows vibrant.

TIP

If you're using tauri@v1, you need to use version 0.4 of this crate.

Platform-specific

  • Linux: Unsupported, Blur and any vibrancy effects are controlled by the compositor installed on the end-user system.

Example

use window_vibrancy::{apply_blur, apply_vibrancy, NSVisualEffectMaterial};

#[cfg(target_os = "macos")]
apply_vibrancy(&window, NSVisualEffectMaterial::HudWindow, None, None)
    .expect("Unsupported platform! 'apply_vibrancy' is only supported on macOS");

#[cfg(target_os = "windows")]
apply_blur(&window, Some((18, 18, 18, 125)))
    .expect("Unsupported platform! 'apply_blur' is only supported on Windows");

macOS Liquid Glass Effect (macOS 26+)

For macOS 26 and newer, you can use the new apply_liquid_glass function with the modern glass effect:

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

#[cfg(target_os = "macos")]
{
    let options = LiquidGlassOptions::new(NSGlassEffectViewStyle::Clear)
        .radius(26.0)
        .opaque(false)
        // macOS 27+ only, ignored on macOS 26
        .interactive(true);

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

The .interactive(true) option enables the glass' visual response to user interactions (NSGlassEffectView.effectIsInteractive). It requires macOS 27 or newer and is silently ignored on macOS 26 and older.

Advanced Usage with WebView:

If you manage the primary content view yourself (for example a WKWebView), you can pass its pointer via the .content_view() method so the crate can reparent it into the glass view's contentView:

use window_vibrancy::{apply_liquid_glass, LiquidGlassOptions, NSGlassEffectViewStyle};
use std::ptr::NonNull;

#[cfg(target_os = "macos")]
{
    let webview: NonNull<std::ffi::c_void> = find_webview(&window);

    let options = LiquidGlassOptions::new(NSGlassEffectViewStyle::Clear)
        .radius(26.0)
        .content_view(webview);

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

For a complete example of WebView integration with Tauri, see examples/tauri/src-tauri/src/main.rs.

Tauri

if you are using tauri, don't forget to:

For a more complete example of usage with tauri, see examples/tauri.

Available functions

FunctionSupported platformsNotes
apply_blur&clear_blurWindows 7/10/11 (22H1 only)Bad performance when resizing/dragging the window on Windows 11 build 22621+.
apply_acrylic&clear_acrylicWindows 10/11Bad performance when resizing/dragging the window on Windows 10 v1903+ and Windows 11 build 22000.
apply_mica&clear_micaWindows 11
apply_vibrancy&clear_vibrancymacOS 10.10 and newer
apply_liquid_glass&clear_liquid_glassmacOS 26 and newerModern glass effect with customizable radius, tint color, opacity and interactive (macOS 27+) options.

Screenshots

apply_blurapply_acrylicapply_micaapply_vibrancy