index.md (2466B)
1 netwmicon 2 ========= 3 4 Description 5 ----------- 6 Enables to set \_NET\_WM\_ICON with a png-image. 7 8 Generally the icon of an application is defined by its desktop-entry. The patch 9 [desktopentry](../desktopentry) serves this purpose. Unfortunately, some 10 programs like [tint2](https://gitlab.com/o9000/tint2) or 11 [alttab](https://github.com/sagb/alttab) can't make use of the desktop-entry and 12 rely instead on a hardcoded icon which has to be defined by the application 13 itself with the window-propery \_NET\_WM\_ICON. Since st doesn't define 14 \_NET\_WM\_ICON this programs can't display the correct icon for st even if a 15 desktop-entry exists. This patch solves this problem. 16 17 Dependencies 18 ------------ 19 - gd 20 21 Defining an icon 22 ---------------- 23 By default each time st starts it will search for a file with the name *st.png* 24 under */usr/local/share/pixmaps/*. If you put an image with this name in the 25 root-directory of the st-repository and call `make install` the image will be 26 installed in */usr/local/share/pixmaps/* automatically. Otherwise you have to 27 put the file there manually. You can try it out with this icon [st.png](st.png) 28 (credit: [flat-remix](https://github.com/daniruiz/flat-remix)). 29 30 Using with desktopentry 31 ----------------------- 32 If you use the [desktopentry](../desktopentry)-patch you should adjust the icon 33 in the file *st.desktop* by replacing the line `Icon=utilities-terminal` with 34 `Icon=st`. 35 36 Most programs which use the desktop-file to determine the icon should be able to 37 find *st.png* under */usr/local/share/pixmaps/*. If not report it to me and try 38 changing in *confing.mk* the line `ICONPREFIX = $(PREFIX)/share/pixmaps` to 39 `ICONPREFIX = $(PREFIX)/share/icons/hicolor/256x256/apps/` and install the icon 40 there. 41 42 Call to action 43 -------------- 44 Maybe somebody would like to create an icon with the st-logo so we could add it 45 here instead of using the icon from flat-remix. 46 47 Credits 48 ------- 49 The code for loading and transforming the image to an appropriate format is in 50 large part from [xseticon](https://www.leonerd.org.uk/code/xseticon/) which is 51 developed by Paul Evans. 52 53 Download 54 -------- 55 * [st-netwmicon-0.8.5-v2.diff](st-netwmicon-0.8.5-v2.diff) 56 * [st-netwmicon-0.8.4.diff](st-netwmicon-0.8.4.diff) (Deprecated) 57 * [netwmicon.sh](netwmicon.sh) (Deprecated. Used for 0.8.4-patch. Look at 58 patch-description to understand how its supposed to work. It seems to distort 59 the icon.) 60 61 Authors 62 ------- 63 * Aleksandrs Stier - <aleks.stier@icloud.com>