https://github.com/bilelmoussaoui/startupwmclassfixer
Will help you fix unrecognized/ugly icons in Linux.
https://github.com/bilelmoussaoui/startupwmclassfixer
desktop linux startupwmclass wmclass
Last synced: over 1 year ago
JSON representation
Will help you fix unrecognized/ugly icons in Linux.
- Host: GitHub
- URL: https://github.com/bilelmoussaoui/startupwmclassfixer
- Owner: bilelmoussaoui
- License: gpl-2.0
- Created: 2015-11-20T23:47:40.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2023-06-28T07:54:24.000Z (about 3 years ago)
- Last Synced: 2025-03-18T02:44:49.818Z (over 1 year ago)
- Topics: desktop, linux, startupwmclass, wmclass
- Language: Shell
- Size: 76.2 KB
- Stars: 31
- Watchers: 4
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# StartupWMClassFixer
It will help you to fix unrecognized, ugly or double icons in Linux.
[](https://www.paypal.me/BilalELMoussaoui)
## Dependencies
- `git`
- `wget`
## How to install
### Arch Linux and Arch-derived distributions
```bash
yay -S startupwmclassfixer
```
### Manual installation
Download the [zipped file](https://github.com/bil-elmoussaoui/StartupWMClassFixer/archive/master.zip) or clone the repository
```bash
git clone https://github.com/bil-elmoussaoui/StartupWMClassFixer.git
```
## How to use
Open the script using
```bash
sudo ./fix
```
Or using this if you've installed the script from a package
```bash
sudo StartupWMClassFixer
```
### Arguments
#### How to revert
You can revert your modifications using `--revert` argument.
```bash
sudo ./fix --revert
```
#### How to use latest version of database file
```bash
sudo ./fix --update
```
## FAQ
### Why using `sudo`
Almost all the application desktop files are stored in `/usr/share/applications` that's why we need root permissions to modify them.
### How the script works
The script will modify the desktop file of supported applications ([list of supported applications](https://github.com/bil-elmoussaoui/StartupWMClassFixer/blob/master/database.csv)) and add/modify `StartupWMClass` key.
For more informations about `StartupWMClass` see [Recognized desktop entry keys](https://specifications.freedesktop.org/desktop-entry-spec/latest/ar01s06.html).
### How to contribute
1. Open the application
2. Open the terminal and type `xprop WM_CLASS`
3. The mouse cursor will change, click on the application window and copy the `WM_CLASS(STRING)` value
4. Clone the repository and modify the database file following this
```
Application Name, Desktop file name, WM_CLASS
```
5. Create a pull request