index.md - sites - public wiki contents of suckless.org
(HTM) git clone git://git.suckless.org/sites
(DIR) Log
(DIR) Files
(DIR) Refs
---
index.md (2882B)
---
1 anybar
2 ======
3
4 Description
5 -----------
6 **dwm-anybar** is a patch for dwm that enables dwm to manage external status
7 bars such as lemonbar and polybar. dwm treats the external bar as it would its
8 own, so all regular dwm commands such as togglebar affect the external bar in
9 the same way.
10
11 The project is being managed and developed on this GitHub
12 [repo](https://github.com/mihirlad55/dwm-anybar). If you discover any bugs or
13 patch incompatabilities, feel free to create an issue there.
14
15
16 Configuration
17 -------------
18 static const int showbar = 1; /* 0 means no bar */
19 static const int topbar = 1; /* 0 means bottom bar */
20 static const int usealtbar = 1; /* 1 means use non-dwm status bar */
21 static const char *altbarclass = "Polybar"; /* Alternate bar class name */
22
23 `showbar` and `topbar` affect the external status bar as it would dwm's status
24 bar. `showbar` must be `1` to show the external bar. `topbar` must be set
25 appropriately as well based on if the external bar is docked at the bottom or
26 the top of the screen. The patch only supports bars docked at the top/bottom of
27 the monitor.
28
29 `usealtbar` must be set to `1` to use an external status bar, otherwise dwm's
30 own bar will be enabled.
31
32 `altbarclass` must be set to the class name of the external status bar for dwm
33 to differentiate it from regular windows. The class name of the bar can be found
34 using `xprop`
35
36 xprop(1):
37 WM_CLASS(STRING) = instance, class
38 ^^^^^
39 altbarclass should be set to this
40 WM_NAME(STRING) = title
41
42
43 Polybar Tray Fix
44 ----------------
45 Since polybar's tray is handled as a separate window and is populated slowly, it
46 is difficult to manage. There is a `polybar-tray-fix` version of the patch that
47 allows dwm to manage the tray. The tray isn't actually managed until the
48 togglebar command is called, but it fixes the issue where toggling the bar would
49 not hide the tray.
50
51 This version of the patch adds `alttrayname` to `config.def.h` which is already
52 set to the correct value.
53
54
55 Download
56 --------
57 * Anybar Patch v1.1.0:
58 [dwm-anybar-20200810-bb2e722.diff](dwm-anybar-20200810-bb2e722.diff)
59 * Anybar Patch v1.0.3 to v1.1.0 Update:
60 [dwm-anybar-v1.0.3-to-v1.1.0.diff](dwm-anybar-v1.0.3-to-v1.1.0.diff)
61 * Anybar Patch (with Polybar tray fix) v1.1.0:
62 [dwm-anybar-polybar-tray-fix-20200810-bb2e722.diff](dwm-anybar-polybar-tray-fix-20200810-bb2e722.diff)
63
64 The latest releases of the patch will always be available first on the project
65 [Releases](https://github.com/mihirlad55/dwm-anybar/releases) page. There are
66 also "update" patches to update from previous versions of the patch.
67
68
69 Related Projects
70 ----------------
71 * [polybar-dwm-module](https://github.com/mihirlad55/polybar-dwm-module)
72 works better with this patch
73
74
75 Authors
76 -------
77 * Mihir Lad - <mihirlad55 at gmail>