From d35e518e394b706cb791e30d4fcf7bd0498217ee Mon Sep 17 00:00:00 2001 From: Aaron Marcher Date: Thu, 10 Aug 2017 21:49:37 +0200 Subject: New README in plain text --- README | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 README (limited to 'README') diff --git a/README b/README new file mode 100644 index 0000000..77659b4 --- /dev/null +++ b/README @@ -0,0 +1,56 @@ +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/power/state +- 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 +- Kernel version +- Keyboard indicators +- Load average +- 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 (OSS/ALSA) +- WiFi signal percentage and ESSID + + +Requirements +------------ +In order to build slstatus you need the Xlib header files and optionally ALSA +for volume percentage. PulseAudio is not supported for various reasons. + + +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 dmenu (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. -- cgit v1.2.3