README.md

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:

• set html, body { background: transparent } see index.html#L12
• set "windows": [ { "transparent": true } ] see tauri.conf.json#L57
• on macos set "macOSPrivateApi": true see tauri.conf.json#L49

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

Available functions

Function	Supported platforms	Notes
apply_blur&clear_blur	Windows 7/10/11 (22H1 only)	Bad performance when resizing/dragging the window on Windows 11 build 22621+.
apply_acrylic&clear_acrylic	Windows 10/11	Bad performance when resizing/dragging the window 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, opacity and interactive (macOS 27+) options.

Screenshots

apply_blur	apply_acrylic	apply_mica	apply_vibrancy