https://github.com/tschaefer/slstatus

slstatus is a status monitor for window managers that use WM_NAME or stdin to fill the status bar.
https://github.com/tschaefer/slstatus

Last synced: about 4 hours ago
JSON representation

slstatus is a status monitor for window managers that use WM_NAME or stdin to fill the status bar.

• Host: GitHub
• URL: https://github.com/tschaefer/slstatus
• Owner: tschaefer
• License: isc
• Created: 2021-03-02T16:50:17.000Z (over 3 years ago)
• Default Branch: tschaefer-master
• Last Pushed: 2023-10-28T15:45:47.000Z (about 1 year ago)
• Last Synced: 2023-10-28T16:31:34.076Z (about 1 year ago)
• Language: C
• Size: 454 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• 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.