aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorNathan Reiner <nathan@reinerweb.ch>2022-05-07 20:57:28 +0200
committerNathan Reiner <nathan@reinerweb.ch>2022-05-07 20:57:28 +0200
commitd98a3cae654f30318e92f0bd19298d8fbfc37bef (patch)
treeaeb0b14a0754cd8411a52e8108d5e7b8c7ed3bff /README.md
parent45e4db99d709cf278415e681c98a0204a9c8ca9e (diff)
execute scripts instead of hardcoded
Diffstat (limited to 'README.md')
-rw-r--r--README.md35
1 files changed, 35 insertions, 0 deletions
diff --git a/README.md b/README.md
index eb26d3e..2d1a1d1 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,38 @@
# status
This is a status script for dwm
+
+## Modules
+
+Each module of your statusbar is a scripts that is located under `~/.local/share/status/`
+
+Each script will be executed in alphanumeric order, so if you want to have
+a specific order in which your bar is displayed use numbers as prefix
+of your scripts like this:
+
+```
+~/.local/share/status:
+ 00_battery
+ 01_volume
+ 02_clock
+ ...
+```
+
+## Usage
+
+To start the status daemon use the `-d` flag.
+If you want that the statusbar updates a *unit*, for example *01_volume* when
+the volume buttons are pressed, just just execute `status -u 01_volume` to
+update the unit.
+
+## Config
+
+In the config under `~/.config/status/config` you can set the following
+variables:
+
+- CMDFIFO: Where to place the FIFO which is the communication layer between
+ the daemon and the update requests. (default: ~/.cache/status)
+- BINDIR: Where your unit files are stored (default: ~/.local/share/status/)
+- AUTOREFRESH: After how many seconds the statusbar should autorefresh (default: 60)
+
+The config is just sourced into the script so just use *POSIX-Shell* Syntax in it.