dwmblocks

my build of dwmblocks
git clone git://git.kocotian.pl/dwmblocks.git
Log | Files | Refs | README | LICENSE

README (1536B)


      1 dwmblocks - Modular status bar for dwm written in c.
      2 
      3 This repository is kocotian's fork of Luke Smith's build:
      4 https://git.lukesmith.xyz/dwmblocks
      5 
      6 The statusbar is made from text output from commandline programs. Blocks are
      7 added and removed by editing the config.h file.
      8 
      9 Most statusbars constantly rerun every script every several seconds to update.
     10 This is an option here, but a superior choice is giving your module a signal
     11 that you can signal to it to update on a relevant event, rather than having it
     12 rerun idly.
     13 
     14 For example, the audio module has the update signal 10 by default.
     15 Thus, running:
     16 	$ pkill -RTMIN+10 dwmblocks
     17 will update it.
     18 
     19 You can also run:
     20 	$ kill -44 $(pidof dwmblocks)
     21 which will have the same effect, but is faster. Just add 34 to your typical
     22 signal number.
     23 
     24 My volume module NEVER updates on its own, instead I have this command run
     25 along side my volume shortcuts in dwm to only update it when relevant.
     26 
     27 Note that if you signal an unexpected signal to dwmblocks, it will probably
     28 crash. So if you disable a module, remember to also disable any cronjobs or
     29 other scripts that might signal to that module.
     30 
     31 Like i3blocks, this build allows you to build in additional actions into your
     32 scripts in response to click events.  See the above linked scripts for examples
     33 of this using the "$BLOCK_BUTTON" variable.
     34 
     35 For this feature to work, you need the appropriate patch in dwm as well:
     36 https://dwm.suckless.org/patches/statuscmd/
     37 Credit for those patches goes to Daniel Bylinka (daniel.bylinka@gmail.com).