slstatus

status monitor
git clone git://git.suckless.org/slstatus
Log | Files | Refs | README | LICENSE

README (1501B)


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