Go to file
Aaron Marcher 456be7ad1f README update (included information) 2016-06-14 19:19:25 +02: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 README update (included information) 2016-06-14 19:19:25 +02:00
TODO.md Added icon to TODO.md 2016-03-20 17:07:00 +01:00
config.def.h added, username, gid, uid 2016-06-13 18:49:50 +02: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 added, username, gid, uid 2016-06-13 18:49:50 +02:00
slstatus.h added, username, gid, uid 2016-06-13 18:49:50 +02: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:

  • battery percentage
  • cpu usage (in percent)
  • date and time
  • disk numbers (free storage, percentage, total storage and used storage)
  • available entropy
  • hostname
  • ip addresses
  • ram numbers (free ram, percentage, total ram and used ram)
  • temperature
  • volume percentage (alsa)
  • wifi percentage

Multiple entries per function 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.