sites

public wiki contents of suckless.org
git clone git://git.suckless.org/sites
Log | Files | 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>