slstatus

You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Go to file

Tobias Tschinkowitz c1f79d741a corrected calculation for swap on openbsd The swapctl(2) function fills the swapent struct with 512KB blocks. As we want to display in GB, i just modified the calculation for this to get the expected output.		8 years ago
components	corrected calculation for swap on openbsd	8 years ago
LICENSE	Add he4d to LICENSE	8 years ago
Makefile	Tweak build system a little bit	8 years ago
README	entropy: Port to OpenBSD	8 years ago
arg.h	Remove unnecessary blank lines after license-notice	9 years ago
config.def.h	Remove cpu_iowait	8 years ago
config.mk	Tweak build system a little bit	8 years ago
slstatus.1	Fix man page .Os field	9 years ago
slstatus.c	fflush(stdout) to print line by line if stdout is not a tty	8 years ago
slstatus.h	Remove cpu_iowait	8 years ago
util.c	Fix coding style	8 years ago
util.h	Added LICENSE statements to all source files	9 years ago

README

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/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 (IPv4 and IPv6)
- 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.


Installation
------------
Edit config.mk to match your local setup (slstatus is installed into the
/usr/local namespace by default). Uncomment OSSLIBS on OpenBSD.

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.


Todo
----
Porting to OpenBSD is the current goal before thinking about a release.

The following functions are not portable at the moment:
- wifi_{perc,essid}