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.
 
 
 
Aaron Marcher d35e518e39
New README in plain text
9 years ago
LICENSE Moved contributors to LICENSE 9 years ago
Makefile Makefile fix and vol_perc fix for mute 10 years ago
README New README in plain text 9 years ago
arg.h new arg.h version by frign 9 years ago
config.def.h add num_files() function for maildirs ;) 9 years ago
config.mk enable stack protector and compile to position independent executable 10 years ago
slstatus.1 added option to output only once and exit afterwards 10 years ago
slstatus.c add num_files() function for maildirs ;) 9 years ago
slstatus.png added my fancy icon 10 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/power/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
- 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 and optionally ALSA
for volume percentage. PulseAudio is not supported for various reasons.


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 dmenu (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.