kwin-effects-forceblur

A fork of the KWin Blur effect for KDE Plasma 6 with the ability to blur any window on Wayland and X11. It cannot be used along with the stock blur effect or any other fork of it.

Latest features are available on the develop branch.

^{Window opacity has been set to 85% in the screenshot.}

Installation

Arch Linux

https://aur.archlinux.org/packages/kwin-effects-forceblur

NixOS

https://gist.github.com/taj-ny/c1abdde710f33e34dc39dc53a5dc2c09

pkgs.kdePackages.callPackage

Building from source

Note

It may be necessary to rebuild the effect after a system upgrade.

Dependencies:

• CMake
• Extra CMake Modules
• Plasma 6
• Qt 6
• KF6
• KWin development packages

git clone https://github.com/taj-ny/kwin-effects-forceblur
cd kwin-effects-forceblur
mkdir build
cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=/usr
make
sudo make install

Usage

Note

The window needs to be transparent in order for the blur to be visible.

1. Install the plugin.
2. Open the Desktop Effects page in System Settings.
3. Disable the Blur effect and any other forks of it as well, such as the one provided by LightlyShaders.
4. Enable the Force Blur effect.

The classes of windows to blur can be specified in the effect settings. You can obtain them in two ways:

• Run qdbus org.kde.KWin /KWin org.kde.KWin.queryWindowInfo and click on the window. You can use either resourceClass or resourceName.
• Right click on the titlebar, go to More Options and Configure Special Window/Application Settings. The class can be found at Window class (application). If there is a space, for example Navigator firefox, you can use either Navigator or firefox.

Window borders will be blurred only if decoration blur is enabled.

Credits

• a-parhom/LightlyShaders - CMakeLists.txt files
• Alban-Boissard/kwin-effects-blur-respect-rounded-decorations - Rounded corners
• thegeekywanderer/kwin-effects-blur-respect-rounded-decorations - Fix for bottom corners