KratozZ12 GitHub avatar

Easy-Liquid-Glass-for-KDE

KratozZ12

A step-by-step tutorial to achieve a liquid glass desktop effect on KDE Plasma using Better Blur DX and a custom Plasma style.

Stars

7

7-day growth

No data

Forks

0

Open issues

0

License

No data

Last updated

2026-07-30

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It provides a clear, practical guide for a visually striking KDE customization, including solutions for common pitfalls like plugin version mismatches and the default refraction strength being zero.

Who it is for

  • KDE Plasma users on Nobara or Fedora-based distros
  • Desktop customization enthusiasts
  • Users who want a glass-like aesthetic for their panel

Use cases

  • Creating a visually unique desktop environment
  • Demonstrating KDE Plasma's theming and compositor capabilities
  • Learning how to configure Better Blur DX for refraction effects

Strengths

  • Clear step-by-step instructions with screenshots
  • Addresses known issues (plugin visibility, blur conflict, refraction default)
  • Provides a ready-to-use custom Plasma style from KDE Store
  • Includes troubleshooting commands for plugin version mismatch

Considerations

  • Only works with KDE Plasma and KWin compositor
  • Requires compiling the Better Blur DX plugin from source
  • Plugin may not appear in UI due to IID mismatch; requires system update and logout

README quick start

Easy Liquid Glass Tutorial

Simple tutorial to have liquid glass in KDE Nobara (or another distro)

1. Install Better Blur DX

Make sure it's the right version for your KWin.

https://github.com/xarblu/kwin-effects-better-blur-dx

Known issue: after installing, the effect may not show up under Desktop Effects even though it's actually loaded. Check with:

$ qdbus org.kde.KWin /Effects org.kde.kwin.Effects.listOfEffects

If it shows up there but not in the UI, it's a KWin plugin version (IID) mismatch — the plugin was built against a different KWin version than the one installed. Fix it with a full system update and reboot:

$ sudo dnf update

2. Install Custom Plasma Style "Sumac Molten Glass"

https://store.kde.org/p/2326896

3. Deactivate KWin's native Blur

This prevents it from conflicting with Better Blur DX (running both at once silently breaks refraction):

$ kwriteconfig6 --file kwinrc --group Plugins --key blurEnabled false

4. Set the panel to Transparent

Refraction only shows up if the panel background is fully Transparent — "Adaptive" isn't enough, since it needs something behind it to distort at all times.

Right-click panel → Edit Panel → Panel background opacity → Transparent

5. Customize Blur

System Settings → Window Management → Desktop Effects → Better Blur DX

You can do this on your own, it's pretty easy, but I'll leave my config here anyway

Heads up: Refraction Strength defaults to 0. If your panel just looks like plain blur with no distortion after enabling the effect, this is why — turn it up manually.

6. Apply changes

For compiled KWin effects like this one, a simple "Apply" isn't always enough — log out and back in to make sure the new values are actually loaded.

Description

KDE liquid glass

Related repositories

Similar projects matched by category, topics, and programming language.

MoonshotAI
Featured
MoonshotAI GitHub avatar

Kimi-K3

Kimi K3 is an open-weight, 2.8T-parameter native multimodal agentic model with a 1M-token context window, designed for frontier coding, knowledge work, and reasoning tasks.

AI & Machine LearningAI Agents
3,348
xuchonglang
Featured
xuchonglang GitHub avatar

investing-for-beginners

A structured investing guide for Chinese beginners covering US stocks, options, and cryptocurrency, with focus on foundational concepts and risk awareness.

Blockchain & Web3
2,739
Krishnagangwal
Featured
Krishnagangwal GitHub avatar

CS-Fundamentals

A curated collection of Computer Science fundamentals (PDFs, notes, cheatsheets, interview question banks) for placement preparation, covering seven core subjects plus general resources.

Data & DatabasesDatabases & Storage
2,326