| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566 |
- slstatus - suckless status
- ==========================
- slstatus is a small tool for providing system status information to other
- programs over the EWMH property of the root window (used by dwm(1)) or
- standard input/output. It is designed to be as efficient as possible by
- only issuing the minimum of system calls required.
- 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.
|
