https://github.com/ckath/sstat

personal status provider for dwm bar
https://github.com/ckath/sstat

dwm-status status statusbar

Last synced: about 1 month ago
JSON representation

personal status provider for dwm bar

• Host: GitHub
• URL: https://github.com/ckath/sstat
• Owner: Ckath
• License: mit
• Created: 2017-09-30T20:10:03.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2024-08-23T19:37:29.000Z (9 months ago)
• Last Synced: 2025-03-24T21:22:10.363Z (about 2 months ago)
• Topics: dwm-status, status, statusbar
• Language: C
• Homepage:
• Size: 29.3 KB
• Stars: 3
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
a simple personal status provider for bars similar to the one in dwm that just take a string of text either through stdin or xroot window title, started as a fork of an old [slstatus ](https://github.com/drkhsh/slstatus) most of the codebase has been rewritten since.

## info functions and features

- battery percentage

- battery state

- battery time left

- battery smapi info

- cpu frequency

- cpu percentage

- datetime

- disk space left/used/available/percentage

- disk io

- entropy

- fan speed (through ibm fan)

- gid

- hostname

- ip

- load average

- network download

- network upload

- memory used/left/available/percentage

- custom shell command

- swap used/left/available/percentage

- temperature

- uid

- uptime

- username

- volume percentage alsa

- volume percentage pulse

- micvolume percentage pulse

- current pulse profile

- wifi essid

- wifi signal percentage

sstat has a fixed refresh execution time adjusted interval of 1 second, this is done to make it easy to have multiple time sensitive functions such as cpu usage and network upload/download speed. it has been written with minimal memory footprint in mind and can easily be launched to background with sstat -d.

## installing and setting up

1. clone repo

2. `make clean install`

3. edit config.h to your liking

4. go back to step 2

## configuration

config.h will contain a bunch of hopefully helpful explanations of the functions available,  more advanced setup examples(personally configs) are also given in the `config.cate.*` files. the main idea is you define your status similar to how you would construct a typical printf, you provide a format and content in the form of functions to make up you final status string. something to keep in mind `PULSE` has to be defined for any pulse functionality.

## usage

it's suggested you start sstat with `sstat -d` from your startup script or other means

    usage: sstat [option]

    

    options:

        -d start daemonized

        -o print status instead of setting it as rootwindow title

        -v print version info and exit

        -h print this info and exit

## todo

- redo/cleanup pulse implementation

- more system info functions

## bugs and contribution

you can report bugs or make feature requests on the issues page

for contribution, just help fix bugs and send a pr, or do whatever really, if it's useful I'll probably merge it.