https://github.com/xalpharax/slstatus

My personal (and late) fork of https://tools.suckless.org/slstatus with GPU VRAM metrics support.
https://github.com/xalpharax/slstatus

slstatus suckless-software

Last synced: about 1 year ago
JSON representation

My personal (and late) fork of https://tools.suckless.org/slstatus with GPU VRAM metrics support.

• Host: GitHub
• URL: https://github.com/xalpharax/slstatus
• Owner: xAlpharax
• License: isc
• Created: 2023-08-14T16:11:15.000Z (almost 3 years ago)
• Default Branch: master
• Last Pushed: 2023-09-06T21:11:28.000Z (almost 3 years ago)
• Last Synced: 2025-03-30T02:51:05.925Z (about 1 year ago)
• Topics: slstatus, suckless-software
• Language: C
• Homepage:
• Size: 38.1 KB
• Stars: 4
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README
  • License: LICENSE

Awesome Lists containing this project

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)

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

- GPU Memory status (percentage used, total amount and used amount of virtual 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.