From d35e518e394b706cb791e30d4fcf7bd0498217ee Mon Sep 17 00:00:00 2001 From: Aaron Marcher Date: Thu, 10 Aug 2017 21:49:37 +0200 Subject: New README in plain text --- README | 56 ++++++++++++++++++++++++++++++++++++++++++++++ README.md | 76 --------------------------------------------------------------- 2 files changed, 56 insertions(+), 76 deletions(-) create mode 100644 README delete mode 100644 README.md diff --git a/README b/README new file mode 100644 index 0000000..77659b4 --- /dev/null +++ b/README @@ -0,0 +1,56 @@ +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 +- Custom shell commands +- Date and time +- Disk status (free storage, percentage, total storage and used storage) +- Available entropy +- Username/GID/UID +- Hostname +- IP address +- 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 dmenu (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. diff --git a/README.md b/README.md deleted file mode 100644 index 408477e..0000000 --- a/README.md +++ /dev/null @@ -1,76 +0,0 @@ -![slstatus](slstatus.png) - -**slstatus** is a suckless and lightweight status monitor for window managers that use WM_NAME as statusbar (e.g. DWM) or any other status bars if they support reading/piping from slstatus. It is written in pure C without any extern programs being executed and only reads from files most of the time. slstatus is meant to be a better alternative to Bash scripts (inefficient) and Conky (bloated and written in C++). - -If you write a bash script that shows system information in WM_NAME (or any other status bar), it executes a huge amount of external commands (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 most of the time. - -Looking at the LOC (lines of code) of the [Conky project](https://github.com/brndnmtthws/conky), it is very interesting: *28346 lines C++, 219 lines Python and 110 lines Lua*. slstatus currently has about **800 lines of clean documented C code** and even includes additional possibilities as it can be customized and extended very easily. Configuring it by customizing the config.h (C header) file is very secure and fast as no config files are parsed at runtime. - -The following information is included: - -- Battery percentage/power/state -- CPU usage (in percent) -- CPU frequency (in MHz) -- Custom shell commands -- Date and time -- Disk[s] status (free storage, percentage, total storage and used storage) -- Available entropy -- Username/GID/UID -- Hostname -- IP addresses -- Kernel version -- Keyboard indicators -- Load averages -- 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 - -Multiple entries per function (e.g. multiple batteries) are supported and everything can be reordered and customized via a C header file (similar to other suckless programs). - -## Usage - -### Installation - -Be sure you satisfy the dependencies: X11 and optionally ALSA (for volume percentage, I will *not* support PulseAudio). -Also you should have basic development tools like a C compiler and GNU make installed. -Then copy config.def.h to config.h and customize it to your needs. -(Re)Compile (and install) it (after modifications): - - $ make clean all - # make install - -### Starting - -If you use DWM or any other window manager that uses WM_NAME, write the following code to ~/.xinitrc (or any other initialization script) to start slstatus automatically: - - slstatus -d - -If you use any other status bar or window manager you will have to figure it out yourself. Something like this could fit your requirements: - - slstatus -o | other_status_bar & - -### Specific function quirks - -- Volume percentage - -If there is no `/dev/mixer` on your system and you use ALSA, it means you have to load the OSS compatibility module by issuing: - -``` -# modprobe snd-pcm-oss -``` - -## Contributing - -Hunt FIXME's in the code or do WTF you want! If it is useful, I will merge. - -People who contributed are listed in [CONTRIBUTORS.md](CONTRIBUTORS.md). Please add yourself to this list afterwards. - -For detailed information about coding style and restrictions see [CONTRIBUTING.md](CONTRIBUTING.md). - -## License - -See [LICENSE](LICENSE). -- cgit v1.2.3