index.md - sites - public wiki contents of suckless.org
HTML git clone git://git.suckless.org/sites
DIR Log
DIR Files
DIR Refs
---
index.md (2990B)
---
1 colored status text
2 ===================
3
4 Description
5 -----------
6 This patch enables colored text in the status bar. It changes the way colors
7 are defined in config.h, allowing the user to define multiple color
8 combinations for use in their status script.
9
10 Configuration
11 -------------
12 Download the patch and apply it according to the [general instructions](../).
13
14 Modify the colors definition in 'config.h' to suit your needs. Make sure to
15 define at least 3 colors as they will be used for 'normal', 'selected', and
16 'urgent' windows, respectively.
17
18 Usage
19 -----
20 Add code to your status script to output the raw characters '\x03' to switch to
21 the 'urgent' color, or '\x04' to switch to the 4th defined color, etc. Note
22 that the color indices in the status text are +1 from the definition in
23 'config.h' (because '\0' is the string terminator). To switch back to the
24 normal text color use '\x01'. To enter the raw character '\x01' in vim, press
25 ctrl+v followed by x, 0, and 1 in that order. '\x01' gives the first character,
26 which appears as a bold "A" on the screen to distinguish it from the regular
27 character A.
28
29 ### Example
30
31 The following definition in 'config.h':
32
33 #define NUMCOLORS 4
34 static const char colors[NUMCOLORS][MAXCOLORS][8] = {
35 // border foreground background
36 { "#000033", "#dddddd", "#000033" }, // normal
37 { "#000088", "#ffffff", "#000088" }, // selected
38 { "#ff0000", "#000000", "#ffff00" }, // urgent/warning (black on yellow)
39 { "#ff0000", "#ffffff", "#ff0000" }, // error (white on red)
40 // add more here
41 };
42
43 Coupled with a matching status script produces the following: 
45
46 A really silly example:
47
48 echo -e "normal \x01 selected \x03 warning/urgent \x04 error \x01 back to normal text" | dwm
49
50 An example status script snippet to take advantage of the colors:
51
52 status=""
53 if [$batperc -le 10]; then
54 # use "warning" color
55 status+="\x03 BAT: $batperc"
56 elif [$batperc -le 5]; then
57 # use "error" color
58 status+="\x04 BAT: $batperc"
59 else
60 # default is normal color
61 status+="BAT: $batperc"
62 fi
63
64 # switch back to normal color for date
65 status+="\x01| "+$(date)
66
67 echo -e $status
68
69 Download
70 --------
71 * [dwm-5.7.2-statuscolors.diff](dwm-5.7.2-statuscolors.diff)
72 * [dwm-5.8.2-statuscolors.diff](dwm-5.8.2-statuscolors.diff)
73 * [dwm-statuscolors-5.9.diff](dwm-statuscolors-5.9.diff)
74 * [dwm-statuscolors-6.1.diff](dwm-statuscolors-6.1.diff)
75 * [dwm-statuscolors-20181008-b69c870.diff](dwm-statuscolors-20181008-b69c870.diff)
76 * [dwm-statuscolors-20220322-bece862.diff](dwm-statuscolors-20220322-bece862.diff)
77 Minor update to make Danny's patch apply again.
78
79 Authors
80 -------
81 * Jeremy Jay - [(original patch)](//lists.suckless.org/dwm/0812/7023.html)
82 * Axel Bayerl - (update to 5.7.2)
83 * Voltaic - (update to 5.8.2, 5.9)
84 * Daniel Raloff (update to 6.1)
85 * Dave Kennedy (fixes to 6.1)
86 * Danny O'Brien - [danny@spesh.com](mailto:danny@spesh.com) (20181008 patch)
87 * [danso](https://danso.ca) (20220322 patch)