mirrors/ghostty
1
0
Fork 0
mirror of https://github.com/ghostty-org/ghostty.git synced 2026-07-31 04:39:01 +00:00
Code Issues Packages Projects Releases Wiki Activity

config: update background-blur to reflect growing adoption

Browse Source 
`ext-background-effect-v1` is finally seeing major adoption throughout
KWin, Mutter, cosmic-comp, Niri, etc. and we should update our comments
on that.
This commit is contained in:
Leah Amelia Chen
2026-07-20 00:17:06 +08:00
parent a887df42c5
commit 2da02f4d28
1 changed files with 8 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
src/config/Config.zig
View File

@@ -1036,27 +1036,15 @@ palette: Palette = .{},
/// If the macOS values are set, then this implies `background-blur = true`
/// on non-macOS platforms.
///
/// Supported on macOS and on some Linux desktop environments, including:
/// On Linux, the exact blur intensity is ignored and any positive integer
/// or `true` value will enable background blur. On Wayland, Ghostty uses
/// the [`ext-background-effect-v1`](https://wayland.app/protocols/ext-background-effect-v1)
/// protocol to enable the blur effect, but this is not always supported
/// on all compositors. Check the documentation of your compositor or
/// desktop environment for blur support and how to configure it.
///
/// * KDE Plasma (Wayland and X11)
///
/// Warning: the exact blur intensity is _ignored_ under KDE Plasma, and setting
/// this setting to either `true` or any positive blur intensity value would
/// achieve the same effect. The reason is that KWin, the window compositor
/// powering Plasma, only has one global blur setting and does not allow
/// applications to specify individual blur settings.
///
/// To configure KWin's global blur setting, open System Settings and go to
/// "Apps & Windows" > "Window Management" > "Desktop Effects" and select the
/// "Blur" plugin. If disabled, enable it by ticking the checkbox to the left.
/// Then click on the "Configure" button and there will be two sliders that
/// allow you to set background blur and noise intensities for all apps,
/// including Ghostty.
///
/// All other Linux desktop environments are as of now unsupported. Users may
/// need to set environment-specific settings and/or install third-party plugins
/// in order to support background blur, as there isn't a unified interface for
/// doing so.
/// On X11, blur can only be enabled when using the KWin compositor
/// as a part of KDE Plasma.
@"background-blur": BackgroundBlur = .false,
/// The opacity level (opposite of transparency) of an unfocused split.