README

   1 slstatus - suckless status
   2 ==========================
   3 slstatus is a suckless status monitor for window managers that use WM_NAME
   4 (e.g. dwm) or stdin to fill the status bar.
   5
   6
   7 Features
   8 --------
   9 - Backlight percentage
  10 - Battery percentage/state/time left
  11 - CPU usage
  12 - CPU frequency
  13 - Custom shell commands
  14 - Date and time
  15 - Disk status (free storage, percentage, total storage and used storage)
  16 - Available entropy
  17 - Username/GID/UID
  18 - Hostname
  19 - IP address (IPv4 and IPv6)
  20 - Kernel version
  21 - Keyboard indicators
  22 - Keymap
  23 - Load average
  24 - Network speeds (RX and TX)
  25 - Number of files in a directory (hint: Maildir)
  26 - Memory status (free memory, percentage, total memory and used memory)
  27 - Swap status (free swap, percentage, total swap and used swap)
  28 - Temperature
  29 - Uptime
  30 - Volume percentage (OSS/ALSA)
  31 - WiFi signal percentage and ESSID
  32
  33
  34 Requirements
  35 ------------
  36 In order to build slstatus you need the Xlib header files.
  37
  38
  39 Installation
  40 ------------
  41 Edit config.mk to match your local setup (slstatus is installed into the
  42 /usr/local namespace by default). Uncomment OSSLIBS on OpenBSD.
  43
  44 Afterwards enter the following command to build and install slstatus (if
  45 necessary as root):
  46
  47     make clean install
  48
  49
  50 Running slstatus
  51 ----------------
  52 See the man page for details.
  53
  54
  55 Configuration
  56 -------------
  57 slstatus can be customized by creating a custom config.h and (re)compiling the
  58 source code. This keeps it fast, secure and simple.
  59
  60
  61 Todo
  62 ----
  63 Cleaning up the whole codebase it the goal before thinking about a release.