Sen descrición

Aaron Marcher a8d5bde6a5 void argument main()		%!s(int64=9) %!d(string=hai) anos
.gitignore	864f2246b5 added config.def.h handling and fixed typo	%!s(int64=10) %!d(string=hai) anos
CONTRIBUTING.md	27b9139dfc Changes to documentation and new screenshot.	%!s(int64=10) %!d(string=hai) anos
CONTRIBUTORS.md	27b9139dfc Changes to documentation and new screenshot.	%!s(int64=10) %!d(string=hai) anos
LICENSE	47a0e8dec3 Initial commit	%!s(int64=10) %!d(string=hai) anos
Makefile	410ba38a01 make config.h target depending on config.def.h	%!s(int64=10) %!d(string=hai) anos
README.md	f6f0c895ce Added shell command function	%!s(int64=9) %!d(string=hai) anos
TODO.md	bf2cdd102e Added icon to TODO.md	%!s(int64=10) %!d(string=hai) anos
config.def.h	f6f0c895ce Added shell command function	%!s(int64=9) %!d(string=hai) anos
config.mk	046e273a7e simplify smprintf by using vasprintf	%!s(int64=10) %!d(string=hai) anos
screenshot.png	27b9139dfc Changes to documentation and new screenshot.	%!s(int64=10) %!d(string=hai) anos
slstatus.c	a8d5bde6a5 void argument main()	%!s(int64=9) %!d(string=hai) anos
slstatus.h	9078fb351d Fixed alsa function + datetime function	%!s(int64=9) %!d(string=hai) anos

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).

If you write a bash script that shows system information in WM_NAME, it executes a huge amount of external command (top, free etc.) every few seconds. This results in high system resource usage. slstatus solves this problem by only using C libraries and/or reading from files in sysfs / procfs.

Looking at the LOC (lines of code) in the Conky project is very interesting: 28.346 lines C++, 219 lines Python and 110 lines Lua. slstatus currently has about 500 lines of clean, well commented C code and even includes additional possibilities as it can be customized and extended very easily. Configuring it by editing config.h (a C header file) is very secure and fast as no config files are parsed at runtime.

The following information is included:

battery percentage
cpu usage (in percent)
custom shell commands
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 the C header file config.h (similar to DWM).

Usage

Installation

Before you continue, please be sure that a C compiler, GNU make and alsa-lib (for volume percentage) are installed. Then copy config.def.h to config.h and edit it to your needs. Recompile and install it after every change via sudo make install!

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.

README.md