Various troubles with Aurorae v2

I have been working on a set of custom window decorations for quite a while now. I am very happy with how they look! Prior to plasma version 6.6, I didn’t have any issues following the developer docs for how to put an SVG theme together. Once I updated to 6.6 though, issues started popping up and they drove me insane for months.

However, I have recently narrowed down that the culprit is the Aurorae v2 renderer.

My issues include:

  • Titlebar decorations for maximized windows rendering incorrectly, significantly reducing readability [this is because, for some unknowable reason, Aurorae v2 makes the decoration stretch to the full size of the window??? Allegedly it’s only for translucent decorations???]
  • Toggle buttons not retaining a pressed state after pressing them [i.e. Keep Above]
  • Various configuration parameters, such as animation time and text shadows, being entirely ignored and nonfunctional
  • New to Plasma 6.7 is an odd visual bug where the center titlebar decoration erroneously shifts vertically a couple pixels when the window title changes- particularly noticeable in the settings program.

All of this leads me to a few questions:

  1. Is any of this behavior intentional?
  2. If so, why?
  3. If not, are there plans to work on these things?

Now, after digging around for months and finding that Aurorae v2 was the root of my issues, I also found a way to revert to v1 by manually editing the kwinrc file, and it works! Problem solved, right? Not even close actually. This method does not persist across a reboot, or even changing your window decorations. I wouldn’t be surprised if even so much as thinking about the settings program makes it revert to v2. Plasma is incredibly eager to force usage of the Aurorae v2 library on any theme you pick.

Or so I thought. It turns out KDE official themes like Breeze and Oxygen have their own specific libraries! But what I care about even more is that Plastik defaults to Aurorae v1. So, my ultimate question in this post is:

How do I make my theme do this? What kind of goofballery must I perform in the files to make Plasma stick to Aurorae v1 for my theme? It is clearly possible. And if it somehow isn’t, is there a way to just force Plasma itself to not use Aurorae v2?

It should be noted that my theme is SVG based- no QML or code of any kind.

Based on my experience, Aurorae v2 seems to have far too many issues with user made themes that worked perfectly fine on v1, to the point where I have questions about why it has even been pushed to the default and not an experimental option somewhere- especially since the Plasma default themes don’t seem to use normal Aurorae anymore. Even the KDE Developer documentation for making an Aurorae theme fails to mention that there are 2 different versions of Aurorae!!!

This has genuinely been driving me insane for months and I am desperate for a complete and working solution.

I’m on 6.7 and I just noticed the issue with titlebar buttons shifting up and down a pixel when hovering over them. It affects almost every SVG-based 3rd party theme I have installed, some worse than others. And I just learned a few days ago that titlebar text shadows was even a feature, but it’s apparently been broken for over a decade?

Screencast_20260627_163613

Screencast_20260627_164533

What did you add to your kwinrc to force Aurorae v1?

Semi-related, one of the more popular Windows 7 themes, Seven Black, broke on me after an update (I’m on Fedora). It was working fine less than a week ago, than after rebooting the glass overlay is suddenly broken and it doesn’t blur the background. I noticed this at the same time as the button issue above started.

And I just learned a few days ago that titlebar text shadows was even a feature, but it’s apparently been broken for over a decade?

Oh wow, I was not aware of that. Looks like the developer docs are even more outdated than I thought…

What did you add to your kwinrc to force Aurorae v1?

at the bottom of kwinrc is the [org.kde.kdecoration2] group. Under that is a parameter called library.

to force Aurorae v1, change that line to be library=org.kde.kwin.aurorae and reapply your decoration in the settings. I also recommend navigating to the window decoration settings before editing the file because, as I mentioned, KDE is very eager to force Aurorae v2. You will have to do this every time you reboot your pc.

So I updated my system last night, which pushed through an update for Aurorae that thankfully fixed the button shifting problem. All the other issues still persist though.

made a script that switches to aurorae v1. you can put it as an autostart login script to fix issues with broken window decorations until aurorae v2 is fixed. kinda a bandaid solution but owell

#!/bin/bash
kwriteconfig6 --file kwinrc --group org.kde.kdecoration2 --key library org.kde.kwin.aurorae
qdbus6 org.kde.KWin /KWin reconfigure