suckless
/
slstatus
mirror of git://git.suckless.org/slstatus
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
status monitor
329 Commits 1 Branch 1 Tag 702 KiB
C 94.6%
Makefile 3.8%
Roff 1.6%
Go to file
Laslo Hunhold 61e44e8948
Get rid of HDR variable 
The HDR variable is used for general purpose headers, which are not
given in this project. arg.h and config.h are only needed for
slstatus.c, not every component $(COM:=.c).

This also fixes a problem introduced in
e04a385364, where config.h is pulled into
the tarball.
 		2017-09-18 10:08:51 +02:00
LICENSE Updated LICENSE 2017-08-12 12:55:53 +02:00
Makefile Get rid of HDR variable 2017-09-18 10:08:51 +02:00
README Added CPU iowait to README 2017-09-16 13:54:28 +02:00
arg.h Remove unnecessary blank lines after license-notice 2017-08-13 23:31:56 +02:00
battery.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
config.def.h slstatus: add cpu_iowait 2017-09-16 13:46:40 +02:00
config.mk Properly declare buf as extern and fix all unused-warnings 2017-09-17 17:38:07 +02:00
cpu.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
datetime.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
disk.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
entropy.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
hostname.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
ip.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
kernel_release.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
keyboard_indicators.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
load_avg.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
num_files.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
ram.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
run_command.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
slstatus.1 Fix man page .Os field 2017-08-13 23:25:44 +02:00
slstatus.c Properly declare buf as extern and fix all unused-warnings 2017-09-17 17:38:07 +02:00
slstatus.h Rewrite Makefile to accomodate file split 2017-09-17 17:37:49 +02:00
swap.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
temperature.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
uptime.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
user.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
util.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
util.h Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
volume.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00
wifi.c Added LICENSE statements to all source files 2017-09-17 17:45:03 +02:00

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
- CPU iowait
- 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 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 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.