Find a file
Ashish Kumar Yadav 26e3281f29 Corrected typo
2020-07-24 21:55:56 +05:30
blocks Change dash to sh in shebang 2020-07-18 17:30:48 +05:30
daemons Change dash to sh in shebang 2020-07-18 17:30:48 +05:30
patches fixed dwm patch 2020-07-18 17:47:54 +05:30
.gitignore Added gitignore 2020-07-18 18:00:09 +05:30
blocks.h Corrected a typo 2020-07-18 19:55:50 +05:30
dwmblocks.c Corrected typo 2020-07-24 21:55:56 +05:30
LICENSE Added license 2020-07-13 14:44:52 +05:30
Makefile Corrected bug in makefile 2020-07-10 01:50:06 +05:30
README.md Coding style improvement in readme 2020-07-24 15:08:16 +05:30
sigdwmblocks.c Improved usage directives 2020-07-14 01:30:57 +05:30
xgetrootname Did some cleanup 2020-07-07 01:58:41 +05:30
xgetrootname.c Did some cleanup 2020-07-07 01:58:41 +05:30

dwmblocks

Modular status monitor for dwm written in C with features including clickability, cursor hinting and color.

Usage

dwmblocks [-d <delimiter>]

Modifying blocks

Blocks are added and removed by editing the blocks.h file. Read it for more info.

Colored output and Clickability

The patches folder contains a patch for dwm which is required for dwmblocks to function properly. It adds support for colored text, clickability and cursor hinting when hovering on text output of clickable blocks (inspired by polybar).

Clickability is inspired by the statuscmd patch for dwm. On clicking on text corresponding to a clickable block, the program specified to handle clicks for that block is executed with the first argument specifying which button was clicked (1 for left, 2 for middle and 3 for right by default).

Colored output is inspired by the statuscolors patch for dwm. To add colors, have your programs for the blocks output raw characters from '\x0b' to '\x31'. '\x0b' in status text switches the active colorscheme to the first one in the scheme array in dwm and so on. See statuscolors patch for more info. Keep in mind that you have to start from '\x0b' instead of '\x01' as instructed on the page.

Signaling changes

To signal a specific block to update, run sigdwmblocks <signal> [<sigval>]. <sigval> is optional and must be an integer. If provided, it is passed as the first argument to the program specified for updating the block.

xgetrootname

It is a tiny program to get the current root name. May prove helpful in debugging.

Installation

Clone the repository and run make clean install after getting in the project directory. By default the program is installed in $HOME/.local/bin. If xgetrootname is required run make xgetrootname.

Acknowledgements

Some ideas and code was taken from other projects. Credits for those go to -

See also

  • dsblocks - A clone of this project with the only difference being that C functions instead of external programs are used to update blocks and handle clicks.