No description
  • C 95.4%
  • Makefile 3.2%
  • Roff 1.4%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
dsp 3fc2872d1b Fix temperature reporting on OpenBSD
On OpenBSD although the formula is correct due to integer division a
temperature of for example 54 celsius appears as 5. this patch first
treats it as a floating point op before retaining the non decimal digits
2020-11-30 21:23:48 +01:00
components Fix temperature reporting on OpenBSD 2020-11-30 21:23:48 +01:00
arg.h Remove unnecessary blank lines after license-notice 2017-08-13 23:31:56 +02:00
config.def.h Add separator module 2020-11-30 21:15:13 +01:00
config.mk Add native OpenBSD support for mute/volume 2019-02-13 13:35:44 +01:00
LICENSE Add native OpenBSD support for mute/volume 2019-02-13 13:35:44 +01:00
Makefile Add separator module 2020-11-30 21:15:13 +01:00
README Add OS-support notice to README 2019-02-16 17:05:04 +01:00
slstatus.1 Remove o-flag as it is redundant 2018-05-22 13:27:11 +02:00
slstatus.c Consistency with 80 char limit and breaks 2018-07-08 17:42:58 +02:00
slstatus.h Add separator module 2020-11-30 21:15:13 +01:00
util.c Follow International System of Units spacing rules 2019-02-17 16:53:56 +01:00
util.h Change uint64_t to uintmax_t 2018-07-07 10:50:25 +02:00

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
------------
Currently slstatus works on FreeBSD, Linux and OpenBSD.
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).

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.