Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/xarblu/kwin-effects-better-blur-dx/llms.txt

Use this file to discover all available pages before exploring further.

Better Blur DX is available on Fedora through a COPR repository maintained by Infinality.

​
Installation

1

Enable the COPR Repository

Enable the Better Blur DX COPR repository:
dnf copr enable infinality/kwin-effects-better-blur-dx
This adds the repository to your DNF configuration.
2

Install the Package

Choose the package for your display server:
3

Enable the Effect

After installation:
  1. Open System Settings > Desktop Effects
  2. Disable any existing blur effects
  3. Enable Better Blur DX

​
COPR Repository Details

For more information about the COPR repository, including build status and available versions: infinality/kwin-effects-better-blur-dx on COPR

​
System Upgrades

Important: After upgrading Plasma or KWin, you must update the package.The effect is compiled against a specific KWin version. After system upgrades:
dnf upgrade kwin-effects-better-blur-dx
Then restart KWin by logging out and back in.

​
Fedora Kinoite (Immutable)

On Fedora Kinoite and other immutable distributions based on it, the installation process is different. See the Manual Build guide for instructions on building in a container.

​
Updating

To update to the latest version: 
# Update all packages including Better Blur DX
dnf upgrade

# Or update only Better Blur DX
dnf upgrade kwin-effects-better-blur-dx
After updating, restart KWin: 
# Log out and log back in, or:
systemctl --user restart plasma-kwin_wayland.service

​
Uninstalling

To remove Better Blur DX: 
dnf remove kwin-effects-better-blur-dx

# Or for X11:
dnf remove kwin-effects-better-blur-dx-x11
To also disable the COPR repository: 
dnf copr disable infinality/kwin-effects-better-blur-dx

​
Troubleshooting

If you encounter issues:
  1. Effect not appearing: Verify the package is installed: 
    rpm -qi kwin-effects-better-blur-dx
  2. Repository errors: Refresh the COPR repository: 
    dnf clean all
dnf makecache
  3. Version conflicts: Ensure you’re on a supported Fedora version (41, 42): 
    cat /etc/fedora-release
  4. Check logs: View KWin logs for errors: 
    journalctl --user -u plasma-kwin_wayland.service -f

​
Supported Fedora Versions

The COPR repository provides packages for:
  • Fedora 41
  • Fedora 42
Older versions may not have pre-built packages available.

​
Next Steps

Learn how to configure Better Blur DX in the Configuration section.

Build docs developers (and LLMs) love

Get started for freeTalk to us