83
Demystifying StartupWMClass (thoughts.greyh.at)
submitted 2 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.

top 17 comments
sorted by: hot top controversial new old
[-] RichardNixos@lemmy.ml 2 points 1 day ago

One thing I've noticed that's funny is that sometimes when I use waypipe to launch a remote app locally it will have a random-ass icon, like a steam game or something

[-] angel@sopuli.xyz 11 points 2 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 2 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 2 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 1 day ago

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

[-] angel@sopuli.xyz 2 points 1 day ago* (last edited 1 day 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 1 day 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 1 day 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 1 day ago

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

[-] angel@sopuli.xyz 1 points 1 day 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?

[-] ButteredBread@sh.itjust.works 6 points 2 days ago

why's there an arch linux app in that image

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

I actually use that logo for my app menu.

[-] ButteredBread@sh.itjust.works 9 points 2 days ago

yea fair enough, kinda makes sense.

[-] deadcream@sopuli.xyz 4 points 2 days ago

I wrote up

I don't think you did.

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

You can think whatever you want.

[-] MonkderVierte@lemmy.zip 2 points 2 days ago
StartupWMClass=

I've never seen this line in a .desktop. What is it for?

[-] Crogdor@lemmy.world 8 points 1 day ago

This is literally what the article was created to explain. Just one more click, my guy, you’re almost there.

this post was submitted on 24 Jun 2026
83 points (100.0% liked)

Linux

65981 readers
176 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