suckless-desktop/avd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Chore: Update README to describe xrsb

Browse Source
This commit is contained in:
Narvin Singh 2020-12-27 14:25:41 -05:00
parent 3ca912c80c
commit 186fce8d9f
1 changed files with 20 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
README.md
View File

@ -1,5 +1,22 @@
status-bar
==========
xrsb
====
Status bar that sets the WM_NAME property of the root window.
xrsb (X Root Window Status Bar) can be used with window managers, such as
[dwm](https://dwm.suckless.org), that display a status bar based on the
name property of the X root window. The application consists of a daemon
(xrsbd) and a scheduler (xrsbs), and is meant to be efficient and precise,
only updating specific parts of the status bar when necessary.
The daemon maintains and updates the status bar (root window name). It traps
the SIGUSR1 signal that is used to tell it that it's time to update. A client,
such as the scheduler, can create action files in a designated action directory
to specify which parts of the status bar the daemon should update. When the
daemon receives the signal, it looks in the action directory for any actions
that is understands, updates the status bar, and removes those files.
The scheduler creates action files in the action directory, then sends the
SIGUSR1 signal to a daemon. The scheduler can send one signal to perform
multiple actions by creating multiple action files, and can create the action
file(s) and send the signal immediately, after some delay, or repeatedly at
some interval.