qugalet/dwmblocks
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
158 commits 1 branch 0 tags 220 KiB
C 64.4%
Shell 30.4%
Makefile 5.2%
Find a file
Ashish Kumar Yadav 9bd2f4dd06 Improved makefile
2021-03-06 12:15:32 +05:30
blocks updateblock - nullterminate 2021-02-09 12:34:20 +05:30
daemons Updated info in pulse_daemon.sh 2021-02-11 02:05:31 +05:30
patches Made left and right padding to status text configurable in dwm patch 2021-01-25 16:50:09 +05:30
sigdwmblocks Reorganization 2021-02-10 21:19:05 +05:30
xgetrootname Reorganization 2021-02-10 21:19:05 +05:30
.gitignore Implemented config.def.h - config.h setup 2021-03-06 03:15:24 +05:30
block.h Reorganization again 2021-02-11 00:16:35 +05:30
config.def.h Implemented config.def.h - config.h setup 2021-03-06 03:15:24 +05:30
dwmblocks.c Small improvement in setupsignals 2021-03-06 03:32:38 +05:30
GNUmakefile Improved makefile 2021-03-06 12:15:32 +05:30
LICENSE Updated year in license 2021-01-02 14:40:31 +05:30
README.md Implemented config.def.h - config.h setup 2021-03-06 03:15:24 +05:30

README.md

dwmblocks

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

Usage

dwmblocks

Configuration

Refer to config.h. It allows addition/removal of blocks and a few other configurations.

make, the first time you run it, or make config.h will create config.h by copying config.def.h.

The provided blocks use siji font for icons.

Colored output and Clickability

patches folder contains two patches for dwm, one for dwm already patched with systray patch and the other for vanilla dwm. One of the patches, whichever appropriate, is essential for dwmblocks to function properly. It will add support for colored text, clickability and cursor hinting when hovering on clickable blocks (inspired by polybar).

Clickability is inspired by 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).

Colored output is inspired by 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 active colorscheme to the first one in the colors array defined in dwm's config.h and so on. See statuscolors patch for dwm 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

A tiny program to get the current root name. May prove helpful in debugging.

Installation

Clone the repository and run

cd dwmblocks
make
sudo make install

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.