https://github.com/PlankCipher/dwmblocks

My build of dwmblocks
https://github.com/PlankCipher/dwmblocks

Last synced: 8 days ago
JSON representation

My build of dwmblocks

• Host: GitHub
• URL: https://github.com/PlankCipher/dwmblocks
• Owner: PlankCipher
• License: isc
• Archived: true
• Created: 2021-07-08T18:38:54.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2021-09-19T11:09:11.000Z (about 3 years ago)
• Last Synced: 2024-08-02T15:32:40.105Z (3 months ago)
• Language: C
• Size: 136 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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](config.def.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](config.def.h).

> The provided blocks use siji font for icons.

# Colored output and Clickability

[patches](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 `\x1f`. `\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](https://dwm.suckless.org/patches/statuscolors/)

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  []`.

`` 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 -

* torrinfail ([original dwmblocks implementation](https://github.com/torrinfail/dwmblocks))

* Daniel Bylinka ([statuscmd patch for dwm](https://dwm.suckless.org/patches/statuscmd/))

* Jeremy Jay ([statuscolors patch for dwm](https://dwm.suckless.org/patches/statuscolors/))

# See also

* [dsblocks](https://github.com/ashish-yadav11/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.