sites

public wiki contents of suckless.org
git clone git://git.suckless.org/sites
Log | Files | Refs

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>