Zander671/dwmblocks
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Alexander Rosenberg 2023-02-23 11:59:57 -08:00
parent 5400dcfc75
commit b0441e32af
Signed by: Zander671
GPG Key ID: 5FD0394ADBD72730
1 changed files with 24 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
README.md
View File

@ -1,15 +1,26 @@
# dwmblocks
Modular status bar for dwm written in c.
# usage
My personal fork of dwmblocks. Original found
[here](https://github.com/torrinfail/dwmblocks).
Dwmblocks is a modular status bar for dwm written in c.
## Usage
To use dwmblocks first run 'make' and then install it with 'sudo make install'.
After that you can put dwmblocks in your xinitrc or other startup script to have it start with dwm.
# modifying blocks
The statusbar is made from text output from commandline programs.
Blocks are added and removed by editing the blocks.h header file.
By default the blocks.h header file is created the first time you run make which copies the default config from blocks.def.h.
This is so you can edit your status bar commands and they will not get overwritten in a future update.
# patches
Here are some patches to dwmblocks that add features that I either don't want to merge in, or that require a dwm patch to work.
I do not maintain these but I will take pull requests to update them.
<br>
<a href=https://gist.github.com/IGeraGera/e4a5583b91b3eec2e81fdceb44dea717>dwmblocks-statuscmd-b6b0be4.diff</a>
After that you can put dwmblocks in your xinitrc or other startup script to have
it start with dwm.
The dwmblocks-pulse-listener program is a small daemon that takes the pid of a
dwmblocks instance and notifies it of pulse audio volume changes.
## Modifying Blocks
The status bar is made from text output from command-line programs. Blocks are
added and removed by editing the blocks.h header file. By default the blocks.h
header file is created the first time you run make which copies the default
config from blocks.def.h. This is so you can edit your status bar commands and
they will not get overwritten in a future update.
## Other Changes
Note that the intervals listed in blocks.h are in milliseconds (1/1000 second).
Because of this, the SECONDS() macro is provided for readability. I also
implemented some changes from Luke Smith's fork found
[here](https://github.com/LukeSmithxyz/dwmblocks).