zayd-mirrors/slstatus
1
0
Fork 0
mirror of https://git.suckless.org/slstatus synced 2025-12-02 17:43:33 -05:00
Code Issues Projects Releases Packages Wiki Activity
No description
613 commits 1 branch 2 tags 652 KiB
Find a file
Exact
drkhsh 8723e8b8c6 more concise memory calculation on Linux 
more flexible parsing for /proc/meminfo to take shared and reclaimable
memory into account. this matches the output with free(1).

additionally this could fix some corner cases, as the order of fields in
/proc/meminfo is not strictly defined.

slstatus:
percent 81% free 2.5 Gi total 23.4 Gi used 19.0 Gi

free(1):
               total        used        free      shared  buff/cache   available
Mem:            23Gi        19Gi       2.5Gi       1.3Gi       3.2Gi       3.6Gi
2025-07-24 22:41:25 +02:00
components more concise memory calculation on Linux 2025-07-24 22:41:25 +02:00
arg.h radical re-formatting 1/3: Fix spacing 2022-10-28 01:03:31 +02:00
config.def.h add 'up' for whether a interface is up or down 2025-04-30 03:09:55 +02:00
config.mk bump version to 1.1 2025-04-30 04:00:57 +02:00
LICENSE fix name confusion in LICENSE 2025-07-16 18:21:43 +02:00
Makefile Fix release tarball to prepare for release 2023-05-15 19:11:39 +02:00
README update LICENSE and README 2025-04-30 03:13:41 +02:00
slstatus.1 Add back version flag to prepare for release 2023-05-15 19:16:12 +02:00
slstatus.c fix compiler warning with newer gcc 2025-04-30 03:11:53 +02:00
slstatus.h add 'up' for whether a interface is up or down 2025-04-30 03:09:55 +02:00
util.c more concise memory calculation on Linux 2025-07-24 22:41:25 +02:00
util.h more concise memory calculation on Linux 2025-07-24 22:41:25 +02:00

README 

slstatus - suckless status
==========================
slstatus is a small tool for providing system status information to other
programs over the EWMH property of the root window (used by dwm(1)) or
standard input/output. It is designed to be as efficient as possible by
only issuing the minimum of system calls required.


Features
--------
- Battery percentage/state/time left
- Cat (read file)
- 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), interface status
- 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
- 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.

- For volume percentage on Linux the kernel module `snd-mixer-oss` must be
  loaded.
- For volume percentage on FreeBSD, `sndio` must be installed.


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.