https://github.com/drkhsh/slstatus

mirror from suckless.org. send patches to hackers@suckless.org mailing list. NO PRs
https://github.com/drkhsh/slstatus

dwm status-bar status-monitor suckless suckless-org suckless-software

Last synced: 11 months ago
JSON representation

mirror from suckless.org. send patches to hackers@suckless.org mailing list. NO PRs

• Host: GitHub
• URL: https://github.com/drkhsh/slstatus
• Owner: drkhsh
• License: isc
• Created: 2016-03-04T09:46:18.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2023-07-04T18:49:53.000Z (over 2 years ago)
• Last Synced: 2025-03-31T04:06:52.436Z (12 months ago)
• Topics: dwm, status-bar, status-monitor, suckless, suckless-org, suckless-software
• Language: C
• Homepage: https://tools.suckless.org/slstatus/
• Size: 484 KB
• Stars: 209
• Watchers: 13
• Forks: 68
• 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)

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