tauri-apps/window-vibrancy

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);

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

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

Screenshots