diff options
author | Bradley Taunt <bt@btxx.org> | 2024-01-17 19:44:16 -0500 |
---|---|---|
committer | Bradley Taunt <bt@btxx.org> | 2024-01-17 19:44:16 -0500 |
commit | c47aa4c4279beb700ec18c83fcf74aafc77d76a4 (patch) | |
tree | 76692ddf485c4453b366ce8df41e35c879cac9d3 /slstatusf/README |
Initial commit to cgit and place all suckless programs within installer
Diffstat (limited to 'slstatusf/README')
-rwxr-xr-x | slstatusf/README | 70 |
1 files changed, 70 insertions, 0 deletions
diff --git a/slstatusf/README b/slstatusf/README new file mode 100755 index 0000000..b3fa7ae --- /dev/null +++ b/slstatusf/README @@ -0,0 +1,70 @@ +slstatus - suckless status +========================== +slstatus is a suckless status monitor for window managers that use WM_NAME +(e.g. dwm) or stdin to fill the status bar. + + +Features +-------- +- Battery percentage/state/time left +- Cat (read file) +- CPU usage +- CPU frequency +- Custom shell commands +- Date and time +- Disk status (free storage, percentage, total storage and used storage) +- Available entropy +- Username/GID/UID +- Hostname +- IP address (IPv4 and IPv6) +- Kernel version +- Keyboard indicators +- Keymap +- Load average +- Network speeds (RX and TX) +- Number of files in a directory (hint: Maildir) +- Memory status (free memory, percentage, total memory and used memory) +- Swap status (free swap, percentage, total swap and used swap) +- Temperature +- Uptime +- Volume percentage +- WiFi signal percentage and ESSID + + +Requirements +------------ +Currently slstatus works on FreeBSD, Linux and OpenBSD. +In order to build slstatus you need the Xlib header files. + +- For volume percentage on Linux the kernel module `snd-mixer-oss` must be + loaded. +- For volume percentage on FreeBSD, `sndio` must be installed. + + +Installation +------------ +Edit config.mk to match your local setup (slstatus is installed into the +/usr/local namespace by default). + +Afterwards enter the following command to build and install slstatus (if +necessary as root): + + make clean install + + +Running slstatus +---------------- +See the man page for details. + + +Configuration +------------- +slstatus can be customized by creating a custom config.h and (re)compiling the +source code. This keeps it fast, secure and simple. + + +Upcoming +-------- + +A release (v1.0) will come soon... ;) +After a long phase of inactivity, development has been continued! |