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

Laslo Hunhold 0efd64ffaa Explicitly list component-objects in the Makefile There was a long tinkering process at farbfeld about this, but the sad truth is that it's the only way to make the Makefile truly portable. Listing it just as $(COM:=.o): config.mk $(REQ:=.h) omits the dependency on the c-file itself, which incurs that strictly speaking the object file is not depending on the source file, which is nonsense. You don't see strictly Posix compliant Makefiles around very often and most use nasty GNU-extensions everywhere. It is a good idea to go ahead as a fitting example and show how to write them portably.		8 years ago
components	Use E-notation for large powers of 10	8 years ago
LICENSE	Add Michael Buch to LICENSE	8 years ago
Makefile	Explicitly list component-objects in the Makefile	8 years ago
README	Revert "Add basic backlight percentage support"	8 years ago
arg.h	Remove unnecessary blank lines after license-notice	9 years ago
config.def.h	Revert "Add basic backlight percentage support"	8 years ago
config.mk	Tweak build system a little bit	8 years ago
slstatus.1	Remove o-flag as it is redundant	8 years ago
slstatus.c	Use E-notation for large powers of 10	8 years ago
slstatus.h	Revert "Add basic backlight percentage support"	8 years ago
util.c	Refactor snprintf-usage in util.c	8 years ago
util.h	Revert "Add basic backlight percentage support"	8 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/time left
- 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 (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
----
Cleaning up the whole codebase it the goal before thinking about a release.