status monitor
Go to file
Aaron Marcher d5d862478d typo license != license.md :P 2016-03-20 14:20:22 +01:00
.gitignore added config.def.h handling and fixed typo 2016-03-04 18:36:47 +01:00
CONTRIBUTING.md Changes to documentation and new screenshot. 2016-03-20 14:18:05 +01:00
CONTRIBUTORS.md Changes to documentation and new screenshot. 2016-03-20 14:18:05 +01:00
LICENSE Initial commit 2016-03-04 10:46:19 +01:00
Makefile make config.h target depending on config.def.h 2016-03-10 11:55:12 +01:00
README.md typo license != license.md :P 2016-03-20 14:20:22 +01:00
TODO.md Changes to documentation and new screenshot. 2016-03-20 14:18:05 +01:00
config.def.h Changes to documentation and new screenshot. 2016-03-20 14:18:05 +01:00
config.mk simplify smprintf by using vasprintf 2016-03-10 11:49:48 +01:00
screenshot.png Changes to documentation and new screenshot. 2016-03-20 14:18:05 +01:00
slstatus.c Easier info function names 2016-03-18 16:15:05 +01:00
slstatus.h Easier info function names 2016-03-18 16:15:05 +01:00

README.md

slstatus

slstatus is a suckless and lightweight status monitor for window managers which use WM_NAME as statusbar (e.g. DWM). It is written in pure C without any system() calls and only reads from files most of the time. It is meant as a better alternative to Bash scripts (inefficient) and Conky (bloated for this use).

The following information is included:

  • wifi percentage
  • battery percentage
  • cpu usage in percent
  • cpu temperature
  • ram usage in percent
  • alsa volume level in percent
  • disk usage
  • date
  • time

Multiple entries (battery, wifi signal, ...) are supported and everything can be reordered and customized via a C header file (similar to DWM).

screenshot

Usage

Installation

Before you continue, please be sure that a C compiler, make and alsa-lib are installed. Then compile the program once using sudo make install. After that you may change config.h to your needs and recompile it after any change!

Starting

Put the following code in your ~/.xinitrc (or similar):

while true; do
    slstatus
done &

The loop is needed that the program runs after suspend to ram.

Contributing

In TODO.md there is a list of things that have to be done.

People who contributed are listed in CONTRIBUTORS.md.

For detailed information about coding style and restrictions see CONTRIBUTING.md

License

See LICENSE.