Skip to content

jdujava/slstatus-jd

Repository files navigation

My fork of slstatus.

To set upstream remote to original slstatus repo:

git remote add upstream git://git.suckless.org/slstatus

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.