85
Demystifying StartupWMClass (thoughts.greyh.at)
submitted 4 days ago by zquestz@lemmy.world to c/linux@lemmy.ml

As the maintainer of Plank Reloaded, the most common bug report I get is "this app has the wrong icon." It's almost never the dock - it's a broken StartupWMClass in the app's .desktop file. So I wrote up how to find the right value on X11, Wayland, and KDE, and why deleting the line often fixes it.

you are viewing a single comment's thread
view the rest of the comments
[-] angel@sopuli.xyz 11 points 4 days ago

I use Firefox nightly and recently switched to Wayland (KDE). Ever since I switched, the taskbar often displays Firefox nightly with the regular Firefox icon, and the name Firefox instead of Firefox nightly. After reading your blog post I'm thinking that the culprit could be an incorrect StartupWMClass. But I don't get why this issue never showed on X11 then.

[-] zquestz@lemmy.world 7 points 4 days ago

Yeah something isn't being matched right. Might want to look at both .desktop files and compare them. Probably be pretty obvious when you look. =)

[-] angel@sopuli.xyz 5 points 4 days ago

I just checked the .desktop file for firefox nightly. It contains only firefox-nightly as its StartupWMClass. So I went ahead and also checked the window class firefox nightly is running as and found the following: Screenshot showing the window properties of firefox nightly in the KDE system settings

Does this mean that firefox nightly is using both, the firefox and the firefox-nightly window classes?

[-] zquestz@lemmy.world 1 points 3 days ago

Yep it has both applied. What are the actual .desktop file names?

[-] angel@sopuli.xyz 2 points 3 days ago* (last edited 3 days ago)

The desktop files are named firefox.desktop and firefox-nightly.desktop, both in /usr/share/applications.

EDIT: For completeness, I also checked the window classes of the regular firefox: Screenshot of the KDE system settings displaying properties of the normal non-nightly firefox window

It can be observed that it uses only the window class firefox, but twice?

[-] zquestz@lemmy.world 1 points 3 days ago

Yeah in your case the best fix is probably REMOVING StartupWMClass from those launchers if it is present. Then it will only match the app id on the .desktop file name.

[-] angel@sopuli.xyz 1 points 3 days ago

Hmm, but I thought the StartupWMClasses in the desktop files are correct? I thought the issue is that firefox-nightly uses the firefox class in addition to the firefox-nightly class

[-] zquestz@lemmy.world 2 points 3 days ago

StartupWMClass is NOT needed if the .desktop file is named correctly.

[-] angel@sopuli.xyz 1 points 3 days ago

I see, so I could remove it, but wouldn't I still see the same behavior, since firefox nightly apparently also uses the firefox window class?

this post was submitted on 24 Jun 2026
85 points (98.9% liked)

Linux

66018 readers
357 users here now

From Wikipedia, the free encyclopedia

Linux is a family of open source Unix-like operating systems based on the Linux kernel, an operating system kernel first released on September 17, 1991 by Linus Torvalds. Linux is typically packaged in a Linux distribution (or distro for short).

Distributions include the Linux kernel and supporting system software and libraries, many of which are provided by the GNU Project. Many Linux distributions use the word "Linux" in their name, but the Free Software Foundation uses the name GNU/Linux to emphasize the importance of GNU software, causing some controversy.

Rules

Related Communities

Community icon by Alpár-Etele Méder, licensed under CC BY 3.0

founded 7 years ago
MODERATORS